Chapter 6 · Chapitre 6 · Créer ton propre plugin
6.1 La structure d'un plugin
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeCré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.