Plugin

Un plugin est un dépôt Git capable de partager d’un coup un ensemble de composants.

Les plugins sont généralement regroupés au sein de marketplaces pour être installés par les agent runtimes, mais ils peuvent aussi être installés directement via l’Agent Package Manager ou certains agent runtimes (comme goose).

Structure

Un plugin est généralement identifié par un fichier plugin.json (peut varier selon l’agent runtime). Son emplacement et son contenu (avec de légères variations) dépendent du (ou des) agent runtime(s) cible(s).

Format : Agent Plugins
Lu par : Copilot, Cursor, Devin, Hermes
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- PLUGIN_DATA (répertoire de données du plugin)

repository/
├── plugin.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── mcp.json
└── com.example.client/
    ├── agents/
    │   └── reviewer.agent.md
    └── hooks/
        └── hooks.json

Le répertoire com.example.client est une extension client. Il contient des composants dans un format spécifique à l’agent runtime (hooks, serveurs MCP, agents, etc.).

Copilot : com.github.copilot/

Format : Claude Code
Aussi lu par : Codex (partiellement), Copilot (partiellement), Devin (partiellement)
Variables d’environnement :
- CLAUDE_PLUGIN_ROOT (répertoire du plugin)
- CLAUDE_PLUGIN_DATA (répertoire de données du plugin)
- CLAUDE_PROJECT_DIR (répertoire de l’espace de travail)
- CLAUDE_PLUGIN_OPTION_<KEY> (valeurs userConfig, compatible uniquement avec Claude Code)

repository/
├── .claude-plugin/
│   └── plugin.json
├── agents/
│   └── reviewer.md
├── commands/
│   └── special.md
├── hooks/
│   └── hooks.json
├── monitors/
│   └── monitors.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── .mcp.json
└── .lsp.json

Format : Codex
Variables d’environnement :
- PLUGIN_ROOT (répertoire racine du plugin)
- PLUGIN_DATA (répertoire de données du plugin)
- CLAUDE_PLUGIN_ROOT / CLAUDE_PLUGIN_DATA (alias conservés pour compatibilité)

repository/
├── .codex-plugin/
│   └── plugin.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks/
│   └── hooks.json
├── .mcp.json
└── .app.json

Format : Copilot
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- COPILOT_PLUGIN_DATA (répertoire de données du plugin, aliasé en CLAUDE_PLUGIN_DATA)

repository/
├── plugin.json
├── agents/
│   └── reviewer.agent.md
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks.json
└── .mcp.json

Format : Cursor

repository/
├── .cursor-plugin/
│   └── plugin.json
├── rules/
│   └── rule-name.mdc
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks/
│   └── hooks.json
└── mcp.json

Format : Antigravity

repository/
├── plugin.json
├── mcp_config.json
├── hooks.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── agents/
│   └── reviewer.md
└── rules/
    └── rule-name.md

Format : Devin
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- PLUGIN_DATA (répertoire de données du plugin)
- DEVIN_PROJECT_DIR (répertoire de l’espace de travail)

repository/
├── .devin-plugin/
│   └── plugin.json
├── AGENTS.md
├── rules/
│   └── rule-name.md
├── agents/
│   └── reviewer.md
├── hooks.json
├── .mcp.json
└── skills/
    └── skill-name/
        └── SKILL.md

Format : Hermes Agent

repository/
├── plugin.yaml
├── __init__.py
└── skills/
    └── skill-name/
        └── SKILL.md

# __init__.py
def register(ctx):
    ctx.register_hook("pre_tool_call", my_pre_tool_call)
    ctx.register_tool("my_tool", my_tool_handler)
    ctx.register_skill("my-skill", "skills/my-skill/SKILL.md")
    ctx.register_command("my-command", my_command_handler)
    # `register_cli_command`, `register_platform`, `register_memory_provider`
    # `register_context_engine`, `register_image_gen_provider`
    # `register_slack_action_handler`, `register_middleware`

Limitations

Format LSP

Bien que les LSP puissent être définis dans .lsp.json, une meilleure approche consiste à les définir en ligne dans plugin.json car leur format varie selon les agent runtimes.