Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ether-moon merged 1 commit into from
Mar 31, 2026
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .knowledge/decisions/2026-03-31-codex-skills-mcp-only.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Decision: Codex 호환은 skills/MCP만 지원

**Decision**: Codex 플러그인 지원 범위를 skills와 MCP 서버로 한정하고, hooks/agents/commands는 Claude Code 전용으로 유지한다.

**Context**: skill-set 플러그인을 OpenAI Codex에서도 사용할 수 있도록 확장하는 과정에서, 전체 기능(skills, agents, hooks, commands, MCP)을 모두 호환시킬지 범위를 결정해야 했다. Codex와 Claude Code는 hooks 이벤트 모델, agents 정의 형식(TOML vs 마크다운), commands 개념 유무 등에서 차이가 있다.

**Rationale**: hooks와 agents까지 Codex 포맷으로 별도 관리하면 중복 코드와 관리 포인트가 늘어나 유지보수가 불편해진다. Claude Code가 메인 플랫폼이므로 이를 기준으로 관리하고, Codex는 양쪽이 이미 동일한 포맷을 공유하는 skills와 MCP만 활용하는 것이 중복 최소화와 유지보수 편의성 측면에서 최선이다. `.codex-plugin/plugin.json` 파일 1개 추가만으로 구현 가능하다.
4 changes: 4 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [1.8.1] - 2026-03-30

### Added

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

Comment on lines 8 to +13

@coderabbitai coderabbitai Bot Mar 31, 2026

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.

### Fixed

- **consulting-peer-llms**: Restrict review command `allowed-tools` from `Bash(command:*)` to `Bash(command:bash *peer-review.sh*)` to structurally prevent agents from bypassing the bundled script and calling `codex -p` directly
Expand Down
11 changes: 11 additions & 0 deletions plugins/skill-set/.codex-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"name": "skill-set",
"description": "Comprehensive productivity skills for coding agents — git workflow automation, code context understanding, peer LLM consulting, prose writing, and more.",
"version": "1.8.1",
"author": {
"name": "ether-moon"
},
"license": "MIT",
"skills": "./skills/",
"mcpServers": "./.mcp.json"
}
Loading