Aller au contenu
Floskool

Chapitre 6 · Chapitre 6 · Créer ton propre plugin

6.1 La structure d'un plugin

Leçon gratuite 9 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Créer un plugin, c'est surtout ranger des fichiers au bon endroit. Voici la disposition standard décrite dans la documentation, avec l'exemple complet que nous allons construire, mon-plugin :

mon-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── legende/
│       └── SKILL.md
├── agents/
│   └── relecteur.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Une règle à ne pas rater : seul plugin.json va dans .claude-plugin/. Tous les autres dossiers (skills/, agents/, hooks/) se placent à la racine du plugin. C'est l'erreur la plus fréquente chez ceux qui débutent.

Chaque skill vit dans son propre sous-dossier skills/<nom>/SKILL.md. Les agents sont des fichiers Markdown dans agents/. Les hooks sont décrits dans hooks/hooks.json. Les serveurs MCP sont définis dans .mcp.json.

Une précision utile

La documentation indique qu'un fichier CLAUDE.md placé à la racine d'un plugin n'est pas chargé comme contexte. Si tu veux donner des instructions à Claude, mets-les dans un skill.

À retenir

  • plugin.json seul dans .claude-plugin/, le reste à la racine.
  • Un dossier par skill, un fichier par agent.
  • Pas de CLAUDE.md dans un plugin : utilise un skill.