Écrire votre première Skill de bout en bout
Construisons une Skill fonctionnelle à partir de zéro et prouvons qu'elle s'active. Nous allons créer une petite Skill « entrée de changelog » — générique et réutilisable.
Étape 1 — Créer le dossier
mkdir -p .claude/skills/changelog-entry
(Utilisez ~/.claude/skills/… pour une Skill personnelle valable dans tous les projets.)
Étape 2 — Écrire SKILL.md
.claude/skills/changelog-entry/SKILL.md :
---
name: changelog-entry
description: Use when the user wants to turn recent git commits into a Keep a Changelog entry.
---
# Changelog Entry
When asked for a changelog entry:
1. Run `git log --oneline -20` to see recent commits.
2. Group them into Added / Changed / Fixed / Removed (Keep a Changelog style).
3. Write concise, user-facing bullets (not raw commit messages).
4. Output only the formatted entry.
La description est le déclencheur — rédigez-la sous la forme « Use when… » pour que Claude la charge au bon moment.
Étape 3 — (Facultatif) ajouter un script d'aide
Les Skills peuvent embarquer des scripts. Ajoutez scripts/recent.sh et référencez-le depuis SKILL.md si vous souhaitez une collecte de données déterministe :
#!/usr/bin/env bash
git log --oneline -20
Étape 4 — Prouver qu'elle se déclenche
Démarrez une session et dites : « Rédige une entrée de changelog pour les travaux récents. » Claude devrait reconnaître l'intention, charger la Skill et suivre ses étapes. Si elle ne s'active pas, c'est probablement que votre description n'est pas assez précise sur le moment où l'utiliser — affinez-la.
Étape 5 — La partager
Empaquetez-la (avec d'autres) dans un plugin pour que votre équipe l'installe en une seule étape — ou contribuez-la aux packs de Skills d'AILmanac.
Pièges
- Description vague → ne se déclenche jamais (ou se déclenche toujours). Soyez précis.
- Trop de choses dans une seule Skill → cantonnez-la à une seule tâche claire.
- Secrets dans une Skill partagée → jamais ; voir Examiner du code tiers.