5.4 KiB
5.4 KiB
Bonnes pratiques — Skills
Skills Claude Code — champs de frontmatter et skills officiels fournis.
| ← Retour à Claude Code Best Practice |  |
Champs de frontmatter (16)
| Champ | Type | Requis | Description |
|---|---|---|---|
name |
string | Non | Nom d'affichage et identifiant /slash-command. Par défaut le nom du répertoire si omis |
description |
string | Recommandé | Ce que fait le skill. Affiché en autocomplétion et utilisé par Claude pour l'auto-découverte |
when_to_use |
string | Non | Contexte additionnel indiquant quand Claude doit invoquer le skill — phrases déclencheuses et exemples de requêtes. Ajouté à description dans la liste des skills, compte dans la limite de 1 536 caractères |
argument-hint |
string | Non | Indice affiché pendant l'autocomplétion (par ex. [issue-number], [filename]) |
arguments |
string/list | Non | Arguments positionnels nommés pour la substitution $name dans le contenu du skill. Accepte une chaîne séparée par des espaces ou une liste YAML — les noms correspondent aux positions des arguments dans l'ordre |
disable-model-invocation |
boolean | Non | Mets true pour empêcher Claude d'invoquer automatiquement ce skill |
user-invocable |
boolean | Non | Mets false pour masquer du menu / — le skill devient connaissance d'arrière-plan uniquement, destiné au préchargement par un agent |
allowed-tools |
string | Non | Outils autorisés sans demande de permission quand ce skill est actif |
disallowed-tools |
string/list | Non | Outils retirés du pool disponible de Claude tant que le skill est actif (par ex. bloquer AskUserQuestion pour une boucle en arrière-plan). Accepte une chaîne séparée par espaces/virgules ou une liste YAML — la restriction se lève au message suivant |
model |
string | Non | Modèle à utiliser quand ce skill s'exécute (par ex. haiku, sonnet, opus) |
effort |
string | Non | Surcharge le niveau d'effort du modèle à l'invocation (low, medium, high, xhigh, max) |
context |
string | Non | Mets fork pour exécuter le skill dans un contexte de sous-agent isolé |
agent |
string | Non | Type de sous-agent quand context: fork est défini (défaut : general-purpose) |
hooks |
object | Non | Hooks de cycle de vie limités à ce skill |
paths |
string/list | Non | Motifs glob qui limitent quand le skill s'auto-active. Accepte une chaîne séparée par des virgules ou une liste YAML — Claude charge le skill uniquement quand il travaille sur des fichiers correspondants |
shell |
string | Non | Shell pour les blocs !`command` — bash (défaut) ou powershell. Requiert CLAUDE_CODE_USE_POWERSHELL_TOOL=1 |
(10)
| # | Skill | Description |
|---|---|---|
| 1 | code-review |
Relit le diff courant à la recherche de bugs de correction au niveau d'effort choisi (low/medium : moins de constats, à forte confiance ; high→max : couverture plus large) — --comment poste les constats en commentaires inline sur la PR |
| 2 | batch |
Exécute des commandes sur plusieurs fichiers en masse |
| 3 | debug |
Débogue des commandes en échec ou des problèmes de code |
| 4 | loop |
Exécute un prompt ou une commande slash à intervalle récurrent (jusqu'à 3 jours) |
| 5 | claude-api |
Construit des apps avec l'API Claude ou le SDK Anthropic — se déclenche sur les imports anthropic / @anthropic-ai/sdk |
| 6 | fewer-permission-prompts |
Parcourt les transcripts à la recherche d'appels Bash/MCP en lecture seule courants et ajoute une allowlist priorisée à .claude/settings.json pour réduire les demandes de permission |
| 7 | run |
Lance et pilote l'app du projet pour voir un changement fonctionner dans l'app réelle (pas seulement les tests). Requiert v2.1.145 |
| 8 | verify |
Build et lance l'app pour confirmer qu'un changement de code fait ce qu'il doit, sans se rabattre sur les tests ou la vérification de types. Requiert v2.1.145 |
| 9 | run-skill-generator |
Apprend à /run et /verify comment construire et lancer le projet — enregistre une recette de lancement par projet dans .claude/skills/run-<name>/. Requiert v2.1.145 |
| 10 | simplify |
Relit le code modifié pour repérer les opportunités de nettoyage (réutilisation, simplification, efficacité, niveau d'abstraction), quatre agents de revue en parallèle. Depuis v2.1.154, il ne traque pas les bugs de correction — utilise /code-review pour cela |
Voir aussi : Dépôt officiel des skills pour des skills installables maintenus par la communauté.