Skip to content
Skills Library
AI & agents · Building & coding

multi-provider-plugins

/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 structuring a portable shared skills library

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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 structuring a portable shared skills library

Original author description

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 structuring a portable shared skills library

How it works

  1. Task → Reference
  2. Instruction File Conventions (CLAUDE.md / AGENTS.md)
  3. Universal Principles
Original SKILL.md headings · 36 lines, 310 words
SKILL.md preview
---
name: multi-provider-plugins
description: 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 structuring a portable shared skills library
metadata:
  last_updated: "2026-06-04"
---

# Multi-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 `@filename` import syntax (e.g. `@AGENTS.md` inlines it).
- **Codex CLI** reads `AGENTS.md` as plain Markdown — **no `@import` or include syntax exists**. `@CLAUDE.md` in AGENTS.md is a broken line, not an import.
- **Best pattern:** Write everything in `AGENTS.md`. Make `CLAUDE.md` contain only `@AGENTS.md`. All tools read AGENTS.md directly; Claude Code imports it inline via the `@` syntax.
- **Codex plugins:** `codex plugin marketplace add/upgrade/remove` only — no `install` subcommand.

## Universal Principles

1. **One `skills/` directory, many adapters.** Skills live once; provider adapters point to them. Never duplicate skill content per provider.

2. **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.

3. **Skills are portable markdown.** SKILL.md frontmatter format is identical across providers. Use clearly-labeled `### Claude Code` / `### Codex` subsections within skill bodies when tool names differ — don't branch in frontmatter.

4. **Bootstrap injection is a last resort.** Claude Code discovers skills natively. Only write bootstrap code when a provider lacks native skill discovery.

5. **Reference implementation.** [obra/superpowers](https://github.com/obra/superpowers) is the canonical example of this architecture running across Claude Code, Codex, OpenCode, Cursor, and Gemini CLI.
Files in this package (6)
  • SKILL.md 3 KB
  • references/architecture-overview.md 4 KB
  • references/bootstrap-patterns.md 5 KB
  • references/provider-adapters.md 5 KB
  • references/shared-skills-library.md 5 KB
  • references/tool-mapping.md 3 KB

Versions

The database has no other skills named multi-provider-plugins.

Database snapshot: 13.11.2026 · package version 96f8f357520a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90scaffolding
    Use when generating project structure for new bundle-plugins, adding or removing platform support (Claude Code, Cursor, Codex, OpenCode, Gemini CLI, OpenClaw), updating platform manifests, or migrating hooks and configuration between platforms
  • 100multi-harness-plugins
    Use when creating, structuring, or validating multi-harness plugins or project-local .agents/ skills, subagents, hooks, rules, and MCP configs across Google Antigravity, Claude Code, Codex CLI, Cursor, OpenCode, and VS Code.
  • 100bb-install-and-connect
    Use when bb is installed but the agent has no bb tools, or when wiring bb into Claude Code, Cursor, VS Code, Codex, Gemini, opencode or another agent host.
  • 90Claude Code Plugin Builder
    Creates Claude Code plugins with proper manifest structure, directory layout, and components (commands, agents, skills, hooks, MCP servers). This is for Claude Code plugins (`.claude-plugin/plugin.json`) — for Codex plugins (`.codex-plugin/plugin.json`) use the `plugin-creator`…
  • 100omniplugin
    Playbook for building and maintaining omni-platform agent plugins (one repo, native installs on Claude Code, Codex, OpenCode, Hermes, Antigravity, Gemini CLI, and more). Use when creating a plugin meant for more than one platform, porting an existing plugin to a new agentic…
  • 90gemini-agent-sdk
    Build Gemini-backed agent workflows and adapters. Use for Google Gemini API/ADK-style runners, Gemini CLI workflow parity, tool calling, structured outputs, or adding a Gemini variant beside Cursor/OpenCode/Claude runners.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.