multi-provider-plugins
Use when making a Claude Code plugin compatible with other AI coding assistants (Codex, OpenCode, Cursor, Gemini CLI), designing multi-provider plugin architecture, adding a provider adapter, or struc
SKILL.mdskills/multi-provider-plugins/SKILL.md
GitHubMulti-Provider Plugins
Route to the reference that matches your task.
Task → Reference
| Task | Read |
|---|---|
| Understand the shared-skills + thin-adapter architecture | references/architecture-overview.md |
| Add or configure a provider-specific adapter (Claude Code, Codex, OpenCode, Cursor, Gemini) | references/provider-adapters.md |
| Map tool names across providers in skill content | references/tool-mapping.md |
| Implement session-start bootstrap injection for a provider | references/bootstrap-patterns.md |
| Structure or audit a portable shared skills library | references/shared-skills-library.md |
Instruction File Conventions (CLAUDE.md / AGENTS.md)
Non-obvious and commonly wrong — apply whenever creating a new project or touching either file:
- Claude Code reads
CLAUDE.md. Supports@filenameimport syntax (e.g.@AGENTS.mdinlines it). - Codex CLI reads
AGENTS.mdas plain Markdown — no@importor include syntax exists.@CLAUDE.mdin AGENTS.md is a broken line, not an import. - Best pattern: Write everything in
AGENTS.md. MakeCLAUDE.mdcontain only@AGENTS.md. All tools read AGENTS.md directly; Claude Code imports it inline via the@syntax. - Codex plugins:
codex plugin marketplace add/upgrade/removeonly — noinstallsubcommand.
Universal Principles
One
skills/directory, many adapters. Skills live once; provider adapters point to them. Never duplicate skill content per provider.Adapters are thin. A provider adapter does the minimum: declare the plugin, point at
skills/, and inject a bootstrap if the provider needs it. No business logic in adapters.Skills are portable markdown. SKILL.md frontmatter format is identical across providers. Use clearly-labeled
### Claude Code/### Codexsubsections within skill bodies when tool names differ — don't branch in frontmatter.Bootstrap injection is a last resort. Claude Code discovers skills natively. Only write bootstrap code when a provider lacks native skill discovery.
Reference implementation. obra/superpowers is the canonical example of this architecture running across Claude Code, Codex, OpenCode, Cursor, and Gemini CLI.