Chapitre 6 · Chapitre 6 · Créer ton propre plugin
6.1 La structure d'un plugin
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementCré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.jsonseul 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.