Skip to content

feat: add Codex plugin support (skills + MCP only) - #13

Merged
ether-moon merged 1 commit into
mainfrom
codex-plugin-support
Mar 31, 2026
Merged

feat: add Codex plugin support (skills + MCP only)#13
ether-moon merged 1 commit into
mainfrom
codex-plugin-support

Conversation

@ether-moon

@ether-moon ether-moon commented Mar 31, 2026

Copy link
Copy Markdown
Owner

Summary

  • OpenAI Codex에서 skill-set 플러그인의 skills와 MCP 서버를 사용할 수 있도록 .codex-plugin/plugin.json 추가
  • hooks, agents, commands는 Claude Code 전용으로 유지 (중복 코드 최소화)

Changes

  • plugins/skill-set/.codex-plugin/plugin.json: Codex 플러그인 매니페스트 신규 생성
  • CHANGELOG.md: 1.8.1에 Codex 호환 항목 추가
  • .knowledge/decisions/2026-03-31-codex-skills-mcp-only.md: 결정사항 기록

Test Plan

  • Codex CLI에서 플러그인이 인식되는지 확인
  • skills/ 디렉토리의 스킬들이 Codex에서 로드되는지 확인
  • MCP 서버(context7, sequential-thinking)가 Codex에서 정상 동작하는지 확인
  • 기존 Claude Code 플러그인 동작에 영향 없는지 확인

Summary by CodeRabbit

  • New Features

    • Added OpenAI Codex compatibility support, enabling integration of skills and MCP servers with Codex-compatible tools and environments.
  • Chores

    • Added decision documentation outlining Codex compatibility scope.
    • Updated changelog for version 1.8.1.

Add .codex-plugin/plugin.json so OpenAI Codex can discover and use
the plugin's skills and MCP servers. Hooks, agents, and commands
remain Claude Code-only to minimize maintenance overhead.
@coderabbitai

coderabbitai Bot commented Mar 31, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

Three files are added to establish Codex compatibility: a decision document recording the policy that Codex support is limited to skills/ and MCP servers while hooks/agents/commands remain Claude Code-specific, a changelog entry documenting the new .codex-plugin/plugin.json file in version 1.8.1, and the plugin manifest itself containing metadata and path configurations.

Changes

Cohort / File(s) Summary
Knowledge & Documentation
.knowledge/decisions/2026-03-31-codex-skills-mcp-only.md, CHANGELOG.md
Decision document and changelog entry documenting Codex compatibility scope and policy boundaries between Codex and Claude Code.
Plugin Configuration
plugins/skill-set/.codex-plugin/plugin.json
New Codex plugin manifest defining metadata (name, version 1.8.1, author, license) and path entries for skills and MCP servers.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 Hoppity hop, a new format blooms,
Codex and Claude in separate rooms,
Skills and MCP dance side by side,
One manifest file, the perfect guide!
Ether-moon's wisdom makes all things clear,
Compatibility magic, hooray and cheer!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: add Codex plugin support (skills + MCP only)' directly and concisely summarizes the main change: adding Codex plugin support with skills and MCP servers.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex-plugin-support

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CHANGELOG.md`:
- Around line 8-13: Add a missing reference-style link definition for the
release tag `[1.8.1]` at the bottom of CHANGELOG.md matching the format used by
other releases (i.e., a `[1.8.1]: <compare or tag URL>` entry that points to the
repo diff or tag), and ensure any file path mentions such as
`.codex-plugin/plugin.json` use forward slashes consistently per the repository
guideline.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 801b1b47-59be-4edf-96bd-0e62f409c8e7

📥 Commits

Reviewing files that changed from the base of the PR and between 7adfb65 and beaa89b.

📒 Files selected for processing (3)
  • .knowledge/decisions/2026-03-31-codex-skills-mcp-only.md
  • CHANGELOG.md
  • plugins/skill-set/.codex-plugin/plugin.json

Comment thread CHANGELOG.md
Comment on lines 8 to +13
## [1.8.1] - 2026-03-30

### Added

- **codex**: Add `.codex-plugin/plugin.json` for OpenAI Codex compatibility (skills and MCP servers)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add the missing [1.8.1] link reference at the bottom.

This heading uses reference-style version notation ([1.8.1]), but no matching link definition is present in the shown reference list. Add it for consistency with other releases.

Suggested patch
+[1.8.1]: https://github.com/ether-moon/skill-set/releases/tag/v1.8.1
As per coding guidelines: "Use forward slashes universally in file paths (never backslashes) for cross-platform compatibility".
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CHANGELOG.md` around lines 8 - 13, Add a missing reference-style link
definition for the release tag `[1.8.1]` at the bottom of CHANGELOG.md matching
the format used by other releases (i.e., a `[1.8.1]: <compare or tag URL>` entry
that points to the repo diff or tag), and ensure any file path mentions such as
`.codex-plugin/plugin.json` use forward slashes consistently per the repository
guideline.

@ether-moon
ether-moon merged commit ba3c6d7 into main Mar 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant