Aller au contenu principal

Écrire votre première Skill de bout en bout

Intermédiaire
What you'll learn
  • Construire une Skill fonctionnelle de zéro et prouver qu'elle s'active vraiment
  • Écrire une description qui se déclenche au bon moment — le seul champ qui décide si une skill s'exécute un jour
  • Décider quand ajouter un script d'aide pour une collecte de données déterministe
  • Diagnostiquer une skill qui ne se déclenche jamais, et connaître les trois pièges qui en sont la cause

Construisons une Skill fonctionnelle 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​

Créer le dossier de la skill

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 — écrivez-la comme « Use when… » pour que Claude la charge au bon moment.

Étape 3 — (Optionnel) 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 voulez 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 essayez le prompt ci-dessous. Claude devrait reconnaître l'intention, charger la skill et suivre ses étapes. Si elle ne s'active pas, votre description n'est probablement pas assez précise sur le moment où l'utiliser — affinez-la.

Prouver que la skill se déclenche

Draft a changelog entry for recent work.

Étape 5 — La partager​

Regroupez-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 → gardez un seul rôle clair.
  • Secrets dans une skill partagée → jamais ; voir Relire du code tiers.
Key takeaways
  • Une skill est un dossier plus un SKILL.md — .claude/skills/<name>/ pour le projet, ~/.claude/skills/ pour tous les projets
  • La description est le déclencheur. Écrivez-la comme « Use when… » pour que Claude la charge au bon moment
  • Les skills peuvent embarquer des scripts — utilisez-en un quand vous voulez une collecte de données déterministe plutôt que de laisser Claude improviser la commande
  • Prouvez que ça marche en formulant l'intention, pas en nommant la skill. Si elle ne se déclenche pas, la description n'est pas assez précise sur le QUAND
  • Gardez une skill pour un seul rôle clair, et ne mettez jamais de secrets dans une skill que vous partagez

Testez-vous

0/3
  1. Votre skill ne s'active jamais, quoi que vous demandiez. Quel champ est presque certainement le problème ?
  2. Vous voulez une skill de changelog disponible dans chaque projet sur lequel vous travaillez, pas seulement celui-ci. Où va-t-elle ?
  3. Pourquoi embarquer un script d'aide comme scripts/recent.sh avec une skill ?

Suite​