64 lines
5.4 KiB
Markdown
64 lines
5.4 KiB
Markdown
# Bonnes pratiques — Skills
|
|
|
|
 <br>
|
|
[](../implementation/claude-skills-implementation.md)
|
|
|
|
Skills Claude Code — champs de frontmatter et skills officiels fournis.
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
|
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
|
</tr>
|
|
</table>
|
|
|
|
---
|
|
|
|
## 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](https://github.com/anthropics/skills/tree/main/skills) pour des skills installables maintenus par la communauté.
|
|
|
|
---
|
|
|
|
## Sources
|
|
|
|
- [Skills Claude Code — Documentation](https://code.claude.com/docs/en/skills)
|
|
- [Découverte des skills dans les monorepos](../reports/claude-skills-for-larger-mono-repos.md)
|
|
- [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
|