Add Claude Code and Codex plugin support#12
Merged
Merged
Conversation
Package the sub-agents skill as an installable plugin for both Claude Code and
Codex, in addition to the existing install.sh path for other Agent Skills
clients.
- .claude-plugin/{plugin.json,marketplace.json}: Claude Code plugin and
single-plugin marketplace manifests (source: "./")
- .codex-plugin/plugin.json: Codex per-plugin manifest with skills pointer and
interface metadata (displayName, descriptions, default prompts)
- .agents/plugins/marketplace.json: Codex marketplace (local source)
- skills/sub-agents/agents/openai.yaml: Codex per-skill interface metadata and
implicit-invocation policy
- README: install section split into Claude Code (plugin), Codex (plugin), and
other clients (install.sh) blocks; Claude Code / Codex / Agent Skills badges
- pyproject.toml: bump version to 0.4.0
Plugin name is "runner", marketplace name is "sub-agents-skills" (matching the
repo), skill name stays "sub-agents". Invocation becomes /runner:sub-agents on
Claude Code and \$sub-agents on Codex.
Validated with `claude plugin validate` and `codex plugin marketplace add`.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
sub-agentsas an installable plugin for Claude Code and Codex, in addition to keeping the existinginstall.shflow for other Agent Skills clients (Cursor, Gemini, VS Code).runner· Marketplace name:sub-agents-skills· Skill name:sub-agents. Invocation becomes/runner:sub-agents(Claude Code) and$sub-agents(Codex).0.4.0(minor) to reflect the new distribution surface.Files Added
.claude-plugin/plugin.json.claude-plugin/marketplace.jsonsource: "./").codex-plugin/plugin.jsonskills: "./skills/").agents/plugins/marketplace.jsonskills/sub-agents/agents/openai.yamlFiles Modified
README.md— Install section restructured into three blocks (Claude Code plugin / Codex plugin / other clients viainstall.sh); Claude Code / Codex / Agent Skills badges added.pyproject.toml— version0.3.1→0.4.0.Design Notes
linear-prism) chosen over the multi-plugin marketplace pattern (à lagalley) because this repo ships exactly one skill. Both marketplace manifests pointsourceat./.skills/sub-agents/SKILL.md— both Claude and Codex auto-discover it. The existinginstall.shpath keeps working; plugin support is purely additive.short_descriptioninopenai.yamlis intentionally shorter than the SKILL.md frontmatterdescription. Per OpenAI Codex docs the field is user-facing UI text shown in the plugin picker; the SKILL.md frontmatter remains the primary progressive-disclosure trigger.Validation
claude plugin validate .claude plugin validate .claude-plugin/plugin.jsoncodex plugin marketplace add .Test Plan
/plugin marketplace add shinpr/sub-agents-skillsthen/plugin install runner@sub-agents-skillsin Claude Code; verify/runner:sub-agentsinvocation workscodex plugin marketplace add shinpr/sub-agents-skillsthen installRunnerfrom the/pluginspicker; verify\$sub-agentsinvocation works./install.sh --target ~/.cursor/skillsstill installs the skill into Cursor as before🤖 Generated with Claude Code