system

system

Codex and Claude Code plugin marketplace repository for reusable skills and skill-scoped agents.

Included Skills

• Codex: $system:maintain-dev-docs
• Claude Code: /system:maintain-dev-docs

Both commands create, update, and audit repo-specific docs/dev guidance from repository evidence.

Structure

• .agents/plugins/marketplace.json lets Codex add this repository as a marketplace source.
• .claude-plugin/marketplace.json lets Claude Code add this repository as a marketplace source.
• plugins/system/ contains the system plugin package.
• plugins/system/.codex-plugin/plugin.json exposes the plugin for Codex.
• plugins/system/.claude-plugin/plugin.json exposes the plugin for Claude Code.
• plugins/system/skills/ contains plugin skills. Add future skills as plugins/system/skills/<skill-name>/SKILL.md.
• plugins/system/skills/<skill-name>/agents/openai.yaml can hold skill-scoped agent metadata when a skill needs an agent surface.

Changing each plugin manifest's name changes the skill prefix used by that host.

Add With Codex

From the repository root:

codex plugin marketplace add .
codex plugin add system@system-plugin

Confirm the plugin is visible:

codex plugin list

Restart Codex after installing or updating plugin metadata so newly added skills are loaded.

Add With Claude Code

From the repository root:

claude plugin marketplace add .
claude plugin install system@system-plugin

Confirm the marketplace and plugin are visible:

claude plugin marketplace list
claude plugin list

Reload plugins after installing or updating plugin metadata:

/reload-plugins

Claude Code Development Test

From the repository root, run Claude Code with the plugin package directory:

claude --plugin-dir ./plugins/system

Then invoke the skill with:

/system:maintain-dev-docs

References

• Codex CLI: codex plugin marketplace --help and codex plugin add --help
• OpenAI Codex plugins overview: https://help.openai.com/en/articles/20001256
• Claude Code plugins: https://code.claude.com/docs/en/plugins
• Claude Code plugin marketplaces: https://code.claude.com/docs/en/plugin-marketplaces