claude-code-extension-builder

Claude Code Extension Builder

Critères de décision — quel type d'extension créer ?

Besoin	Type d'extension
Réutiliser un workflow de prompt	Skill (SKILL.md)
Déclencher une action sur événement Claude	Hook (.claude/settings.json)
Exposer un outil externe (DB, API, fs)	Serveur MCP
Composer plusieurs skills en une commande	Slash command custom

---

Workflow en étapes

1. Analyser le besoin

• Identifier le workflow répétitif ou l'outil à connecter.
• Répondre à : déclenchement automatique ou à la demande ? sortie texte, fichier, ou action ?
• Choisir le type (tableau ci-dessus) avant toute implémentation.

---

2. Créer un Skill (SKILL.md)

Structure minimale obligatoire :

---
name: mon-skill                    # kebab-case, unique dans la collection
description: Une ligne, termine avec les phrases de déclenchement entre guillemets. Se déclenche avec "mot-clé A", "mot-clé B".
---

# Mon Skill

## Workflow

1. **Étape 1** — description actionnable.
2. **Étape 2** — ...

## Règles

- Règle 1 (obligatoire, concise).

Bonnes pratiques :

• name = identifiant technique → dossier agent-skills/<category>/<name>/SKILL.md.
• description : ≤ 2 phrases ; les triggers entre guillemets couvrent les synonymes naturels de l'utilisateur.
• Corps : 80-180 lignes, pas de section ## Communication Rules (ajoutée automatiquement).
• Langue : français, termes techniques en anglais.

Arborescence collection :

agent-skills/
  dev/
    mon-skill/
      SKILL.md
  devops/
    ...

---

3. Configurer des Hooks

Les hooks interceptent les événements Claude Code pour automatiser des actions.

Fichier : .claude/settings.json (projet) ou ~/.claude/settings.json (global).

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '[hook] commande bash interceptée'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node scripts/notify-slack.js"
          }
        ]
      }
    ]
  }
}