Skip to content
Floskool

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

6.1 La structure d'un plugin

Free lesson 9 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

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.