Creer votre premier skill

Objectifs

A l’issue de cette lecon, vous serez capable de :

• Creer un skill de zero avec le bon format de frontmatter
• Tester et verifier qu’un skill se charge correctement dans Claude Code
• Expliquer comment Claude Code fait correspondre les requetes aux skills disponibles
• Decrire la hierarchie de priorite des skills (Enterprise, Personnel, Projet, Plugins)

Creer un skill

Construisons un skill personnel qui apprend a Claude a rediger des descriptions de PR dans un format coherent. Comme c’est un skill personnel, il se trouve dans votre repertoire personnel et fonctionne dans tous vos projets.

D’abord, creez un repertoire pour votre skill dans le dossier skills :

mkdir -p ~/.claude/skills/pr-description

Puis creez un fichier SKILL.md dans ce repertoire. Le fichier comporte deux parties separees par les tirets du frontmatter :

---
name: pr-description
description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request.
---

When writing a PR description:

1. Run `git diff main...HEAD` to see all changes on this branch
2. Write a description following this format:

## What
One sentence explaining what this PR does.

## Why
Brief context on why this change is needed

## Changes
- Bullet points of specific changes made
- Group related changes together
- Mention any files deleted or renamed

• Le name identifie votre skill.
• La description indique a Claude quand l’utiliser — c’est le critere de correspondance.
• Tout ce qui suit le second bloc de tirets constitue les instructions que Claude suivra quand le skill sera active.

Tester votre skill

Claude Code charge les skills au demarrage : redemarrez votre session apres en avoir cree un. Vous pouvez verifier sa disponibilite en consultant la liste des skills.

Pour le tester, faites des modifications sur une branche et dites quelque chose comme “ecris une description de PR pour mes changements”. Claude indiquera qu’il utilise le skill pr-description, consultera votre diff, et redigera une description selon votre template — meme format a chaque fois.

Comment fonctionne la correspondance

Quand Claude Code demarre, il scanne quatre emplacements pour les skills mais ne charge que le nom et la description — pas le contenu complet.

Quand vous envoyez une requete, Claude compare votre message aux descriptions de tous les skills disponibles. Par exemple, “explique ce que fait cette fonction” correspondrait a un skill decrit comme “explique du code avec des diagrammes visuels” parce que l’intention se recoupe.

Une fois la correspondance trouvee, Claude vous demande de confirmer le chargement du skill. Cette etape de confirmation vous permet de savoir quel contexte Claude s’apprete a charger.

Hierarchie de priorite

Si vous clonez un depot qui contient un skill portant le meme nom que l’un de vos skills personnels, lequel l’emporte ? Il existe un ordre de priorite clair :

1. Enterprise — parametres geres, priorite la plus elevee
2. Personnel — votre repertoire personnel (~/.claude/skills)
3. Projet — le repertoire .claude/skills dans le depot
4. Plugins — plugins installes, priorite la plus basse

Cela permet aux organisations d’imposer des standards via les skills enterprise tout en autorisant la personnalisation individuelle.

Pour eviter les conflits, utilisez des noms descriptifs. Au lieu de simplement “review”, preferez “frontend-review” ou “backend-review”.

Mettre a jour et supprimer un skill

• Pour mettre a jour un skill, editez son fichier SKILL.md.
• Pour supprimer un skill, supprimez son repertoire.
• Redemarrez toujours Claude Code apres toute modification.

Questions de reflexion

• Quelle tache de votre workflow quotidien pourriez-vous transformer en skill des maintenant ? A quoi ressemblerait la description ?
• Comment la hierarchie de priorite pourrait-elle influencer la strategie de gestion des skills de votre equipe ?