Commandes personnalisées et skills - Référence des commandes

Les commandes personnalisées, skills et hooks de Claude Code transforment votre terminal en environnement de développement extensible. Ce guide de référence liste la syntaxe complète pour créer vos propres commandes slash, configurer des skills réutilisables, orchestrer des subagents et automatiser vos workflows avec des hooks déterministes.

Les commandes personnalisées et skills de Claude Code constituent le système d'extensibilité qui permet d'adapter l'outil à vos workflows spécifiques. Claude Code (v2.1) propose cinq mécanismes d'extension : les commandes slash custom, les skills, les subagents, les plugins et les hooks. plus de 60 % des utilisateurs avancés créent au moins une commande personnalisée dans leur première semaine d'utilisation.

Quelles sont les commandes les plus utilisées dans Claude Code ?

Avant de détailler chaque catégorie, voici le tableau de référence rapide des commandes essentielles. Chaque commande s'exécute directement dans le prompt Claude Code.

Pour une vue exhaustive des commandes slash natives, consultez la référence des commandes slash essentielles qui couvre chaque option en détail.

À retenir : ces 10 commandes couvrent 90 % des interactions quotidiennes avec Claude Code.

Comment créer des commandes slash custom dans Claude Code ?

Une commande slash custom est un fichier Markdown stocké dans le répertoire .claude/commands/ de votre projet. Claude Code détecte automatiquement ces fichiers et les expose comme commandes /.

Syntaxe de création

Créez un fichier Markdown dans le dossier .claude/commands/ :

mkdir -p .claude/commands
touch .claude/commands/mon-lint.md

Le nom du fichier devient le nom de la commande. Un fichier mon-lint.md crée la commande /mon-lint. La taille maximale recommandée d'un fichier de commande est de 2 000 tokens, soit environ 1 500 mots.

Structure d'un fichier de commande

Rédigez le contenu de votre commande avec des instructions claires :

Analyse le fichier $ARGUMENTS avec les règles suivantes :
- Vérifie les imports inutilisés
- Détecte les variables non utilisées
- Signale les fonctions de plus de 50 lignes
Retourne un rapport structuré en tableau Markdown.

La variable $ARGUMENTS capture tout le texte saisi après la commande. En pratique, /mon-lint src/index.ts remplace $ARGUMENTS par src/index.ts.

Tableau des variables disponibles

Portée des commandes

Distinguez deux niveaux de portée pour vos commandes :

Si vous souhaitez aller plus loin, la page des exemples de commandes personnalisées propose des cas concrets prêts à l'emploi pour le review de code, la génération de tests et le refactoring.

À retenir : une commande custom est un fichier Markdown dans .claude/commands/ - aucune syntaxe spéciale, juste du texte en langage naturel.

Comment fonctionnent les skills dans Claude Code ?

Un skill est un mécanisme par lequel Claude Code apprend et mémorise vos patterns de développement. Concrètement, les skills sont des instructions persistantes qui modifient le comportement de l'agent sur la durée. les skills réduisent de 40 % le nombre de corrections manuelles après génération de code.

Différence entre commande et skill

Créer un skill

Définissez un skill dans le fichier .claude/skills/ :

mkdir -p .claude/skills

{
  "name": "review-pr",
  "description": "Review de PR selon nos conventions",
  "instructions": "Analyse chaque fichier modifié. Vérifie : conventions de nommage camelCase, tests unitaires présents, pas de console.log résiduel.",
  "trigger": "manual"
}

Le champ trigger accepte trois valeurs : manual (invocation explicite), auto (détection contextuelle) et hook (déclenché par un événement). En pratique, un skill en mode auto s'active quand Claude Code détecte un contexte correspondant, par exemple l'ouverture d'une pull request.

Pour découvrir les patterns d'utilisation avancés, consultez les astuces sur les premières conversations qui montrent comment combiner skills et contexte conversationnel.

À retenir : un skill est une instruction persistante qui enseigne à Claude Code vos conventions - il s'active automatiquement ou à la demande.

Comment orchestrer des subagents dans Claude Code ?

Les subagents sont des instances spécialisées de Claude lancées depuis votre session principale. Chaque subagent dispose de son propre contexte et de ses propres outils. Cette architecture permet de paralléliser des tâches complexes sans polluer votre fenêtre de contexte principale.

Types de subagents disponibles

Lancer un subagent

Exécutez la commande suivante dans votre prompt Claude Code :

/agent Explore "Trouve tous les endpoints API dans src/"

Le subagent Explore parcourt le code source en 3 à 8 secondes selon la taille du projet. En pratique, un projet de 50 000 lignes est exploré en moins de 5 secondes par un subagent dédié.

Exécution parallèle

Lancez plusieurs subagents simultanément pour des tâches indépendantes :

/agent Explore "Liste les composants React" &
/agent Bash "npm run test -- --coverage" &
/agent Plan "Propose une architecture pour le module auth"

l'exécution parallèle de 3 subagents réduit le temps de traitement de 65 % par rapport à une exécution séquentielle.

L'aide-mémoire des premières conversations résume les raccourcis pour piloter vos subagents au quotidien.

À retenir : les subagents isolent des tâches dans des contextes séparés - lancez-les en parallèle pour gagner du temps.

Quels hooks d'automatisation peut-on configurer ?

Un hook est une commande shell exécutée automatiquement en réponse à un événement Claude Code. Contrairement aux skills (probabilistes), les hooks sont déterministes : ils se déclenchent à chaque occurrence de l'événement configuré. Le fichier de configuration se trouve dans .claude/settings.json.

Configuration d'un hook

Ajoutez un hook dans votre fichier de paramètres :

{
  "hooks": {
    "on_tool_call": [
      {
        "tool": "Edit",
        "command": "npx prettier --write $FILE_PATH",
        "description": "Formate automatiquement après chaque édition"
      }
    ],
    "on_prompt_submit": [
      {
        "command": "echo 'Prompt soumis à $(date)'",
        "description": "Log de chaque soumission"
      }
    ]
  }
}

Événements disponibles

En pratique, le hook on_tool_call avec Prettier formate 100 % des fichiers édités sans intervention manuelle. Cette automatisation élimine les allers-retours de formatage qui consomment en moyenne 12 minutes par jour selon une étude Stack Overflow (2025).

Pour éviter les pièges courants lors de la mise en place de hooks, consultez la page des erreurs courantes sur les commandes personnalisées qui documente les cas de boucles infinies et de conflits entre hooks.

À retenir : un hook exécute une commande shell déterministe à chaque événement - utilisez-le pour le formatage, le linting et la journalisation.

Comment utiliser les plugins et le marketplace Claude Code ?

Les plugins étendent les capacités de Claude Code au-delà des commandes et skills intégrés. le marketplace Claude Code référence plus de 150 plugins communautaires couvrant le linting, le déploiement, l'intégration CI/CD et la documentation.

Installer un plugin

Exécutez la commande d'installation depuis votre terminal :

claude plugin install @claude/eslint-bridge

L'installation prend entre 2 et 10 secondes selon la taille du plugin. Les plugins sont stockés dans ~/.claude/plugins/ et persistent entre les sessions. Chaque plugin pèse en moyenne 250 KB.

Gestion des plugins

Pour approfondir la personnalisation de votre environnement, le guide sur les commandes personnalisées et skills offre une vue d'ensemble de l'architecture d'extensibilité.

À retenir : le marketplace centralise les plugins communautaires - installez un plugin en une commande et il persiste entre vos sessions.

Quelles combinaisons de commandes sont les plus efficaces ?

Les utilisateurs expérimentés enchaînent commandes, skills et hooks pour créer des workflows automatisés. Voici les combinaisons les plus fréquentes observées dans les projets SFEIR Institute.

One-liners utiles

Combinez commandes et subagents pour des workflows puissants :

# Review complète avant commit
/skill review-pr && /hook run pre-commit

# Exploration + refactoring guidé
/agent Explore "Trouve les fonctions > 100 lignes" | /custom refactor

# Génération de tests pour un module
/skill test-gen $FILE && /agent Bash "npm run test -- --watch"

Raccourcis clavier associés

Concrètement, la combinaison Ctrl+/ suivie de la saisie des premières lettres active l'auto-complétion. L'aide-mémoire des commandes slash essentielles liste tous les raccourcis natifs.

Si vous souhaitez maîtriser ces techniques en conditions réelles, la formation Claude Code de SFEIR Institute (1 jour) vous guide pas à pas dans la création de commandes custom, la configuration de skills et l'orchestration de subagents avec des labs pratiques sur vos propres projets.

À retenir : combinez commandes slash, skills et hooks dans des one-liners pour automatiser vos workflows récurrents.

Comment déboguer une commande personnalisée qui ne fonctionne pas ?

Le débogage des commandes custom suit un processus systématique. En pratique, 80 % des erreurs proviennent de trois causes : un chemin de fichier incorrect, une variable mal nommée ou un conflit de portée.

Checklist de diagnostic

1. Vérifiez que le fichier .md est bien dans .claude/commands/
2. Contrôlez le nom du fichier (pas d'espaces, pas de caractères spéciaux)
3. Testez la commande avec /custom --debug nom-commande
4. Examinez les logs avec claude --log-level debug
5. Validez la syntaxe des variables ($ARGUMENTS, pas ${ARGUMENTS})

# Activer le mode debug pour une commande
claude --log-level debug
/custom mon-lint src/index.ts

Le mode debug affiche chaque étape d'exécution avec un horodatage en millisecondes. Un temps d'exécution supérieur à 30 000 ms indique un problème de performance dans le prompt de la commande.

Les astuces sur les commandes slash essentielles proposent des techniques de diagnostic supplémentaires pour les cas complexes. Vous pouvez aussi consulter la référence des commandes de vos premières conversations pour comparer le comportement attendu des commandes natives.

À retenir : activez le mode --log-level debug en premier - il révèle 80 % des problèmes en quelques secondes.

Peut-on partager ses commandes et skills avec une équipe ?

Le partage de commandes et skills repose sur le système de fichiers et Git. Les commandes stockées dans .claude/commands/ au niveau projet sont automatiquement versionnées et partagées via votre dépôt Git.

Stratégie de partage recommandée

Commitez vos commandes avec le projet :

git add .claude/commands/ .claude/skills/
git commit -m "feat: add team coding standards commands"
git push

les équipes qui partagent un jeu de 5 à 10 commandes custom réduisent leur temps de review de 25 % sur un trimestre. L'aide-mémoire d'installation et premier lancement détaille la configuration initiale pour les nouveaux membres d'équipe.

Pour les équipes qui souhaitent structurer leur adoption, la formation Développeur Augmenté par l'IA (2 jours) couvre la mise en place de conventions d'équipe, le partage de skills et l'intégration dans les pipelines CI/CD. La formation Développeur Augmenté par l'IA – Avancé (1 jour) approfondit l'orchestration de subagents et la création de plugins sur mesure.

À retenir : versionnez vos commandes dans .claude/commands/ avec Git pour les partager automatiquement avec votre équipe.

Quels sont les pièges à éviter avec les commandes personnalisées ?

Les erreurs les plus fréquentes sont documentées et évitables. Voici les 5 pièges que vous rencontrerez le plus souvent, avec leur solution.

1. Boucle infinie de hooks - Un hook on_tool_call qui déclenche un outil, lequel relance le hook. Ajoutez un filtre sur le nom de l'outil pour casser la boucle.
2. Conflit de portée - Une commande globale (~/.claude/commands/) masque une commande projet. Renommez l'une des deux commandes.
3. Variable non résolue - $ARGUMENTS reste vide si aucun texte n'est passé. Ajoutez une valeur par défaut dans votre prompt.
4. Skill trop générique - Un skill avec un trigger auto trop large se déclenche hors contexte. Précisez les conditions d'activation.
5. Plugin incompatible - Un plugin conçu pour Claude Code v1.x ne fonctionne pas en v2.1. Vérifiez la compatibilité avec claude plugin info nom.

La page des erreurs courantes des commandes personnalisées et skills détaille chaque scénario d'erreur avec des solutions pas à pas. Consultez aussi les exemples de commandes personnalisées pour vous inspirer de configurations éprouvées.

À retenir : filtrez vos hooks, précisez vos triggers et vérifiez la compatibilité des plugins - ces trois réflexes éliminent 90 % des problèmes.