Commandes personnalisées et skills - Aide-memoire

Cet aide-mémoire regroupe toutes les syntaxes pour créer vos propres commandes slash, configurer des skills réutilisables, orchestrer des subagents et automatiser vos workflows Claude Code avec des hooks. Consultez cette fiche pratique pour maîtriser les commandes personnalisées, les skills et l'extensibilité de Claude Code en quelques minutes.

Les commandes personnalisées et skills dans Claude Code constituent le système d'extensibilité qui permet d'adapter l'agent IA à vos workflows spécifiques. Claude Code (v1.0.33) propose quatre mécanismes complémentaires : les commandes slash custom, les skills, les subagents et les hooks. plus de 60 % des utilisateurs avancés créent au moins une commande personnalisée dès la première semaine d'utilisation.

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

Les commandes slash custom étendent le jeu de commandes intégrées. Chaque commande correspond à un fichier Markdown stocké dans .claude/commands/ (projet) ou ~/.claude/commands/ (global). Consultez la référence complète des commandes pour la liste exhaustive des commandes intégrées.

En pratique, une commande slash custom réduit un prompt de 200 mots à 2 mots. La fiche des commandes slash essentielles couvre les commandes intégrées en détail.

À retenir : chaque commande slash custom est un fichier Markdown dans .claude/commands/ qui encapsule un prompt réutilisable.

Comment créer une commande slash personnalisée étape par étape ?

Une commande personnalisée est un fichier Markdown dont le nom devient le suffixe de la commande. Créez le répertoire .claude/commands/ à la racine de votre projet si ce n'est pas déjà fait.

Structure du fichier de commande

# Créer le répertoire de commandes projet
mkdir -p .claude/commands

# Créer une commande /custom:review
touch .claude/commands/review.md

Le contenu du fichier Markdown constitue le prompt envoyé à Claude Code. Vous pouvez utiliser la variable $ARGUMENTS pour capturer les arguments passés après la commande.

<!-- .claude/commands/review.md -->
Analyse le fichier $ARGUMENTS et fournis :
1. Les bugs potentiels
2. Les problèmes de performance
3. Les suggestions d'amélioration
Réponds en français avec des exemples de code corrigé.

Portée projet vs globale

Exécutez votre commande en tapant /custom:review src/auth.ts dans le prompt Claude Code. La commande accepte tous les arguments textuels après le nom. Concrètement, le fichier fait entre 5 et 500 lignes selon la complexité du prompt.

Pour éviter les erreurs courantes lors de la création, consultez le guide des erreurs fréquentes qui détaille les pièges classiques.

À retenir : nommez vos fichiers de commande avec des noms courts et explicites - le nom du fichier devient la commande.

Comment fonctionnent les skills pour que l'IA apprenne vos patterns ?

Les skills représentent un niveau au-dessus des commandes slash : ce sont des instructions persistantes que Claude Code charge automatiquement selon le contexte. Un skill est un fichier Markdown placé dans .claude/ qui décrit des conventions, patterns ou règles métier.

Types de skills disponibles

# Skill projet : conventions de code
echo "Utilise toujours des arrow functions en TypeScript" > .claude/CLAUDE.md

# Skill spécifique à un répertoire
echo "Les composants React suivent le pattern Container/Presenter" > src/components/.claude/CLAUDE.md

les skills réduisent de 40 % le nombre de corrections manuelles sur les projets qui les adoptent. Vérifiez que votre fichier CLAUDE.md contient des instructions claires et concises - Claude Code le lit intégralement à chaque démarrage.

La page dédiée aux commandes personnalisées et skills approfondit la mécanique de chargement contextuel des skills.

Bonnes pratiques pour les skills

• Soyez spécifique : "Utilise vitest pour les tests" plutôt que "utilise un bon framework de test"
• Donnez des exemples : incluez des blocs de code montrant le pattern attendu
• Limitez la taille : visez 50 à 200 lignes par fichier skill pour un chargement rapide
• Structurez par thème : séparez les conventions de nommage, les patterns d'architecture et les règles de test

En pratique, un fichier CLAUDE.md de 100 lignes se charge en moins de 50 ms et reste en mémoire pendant toute la session.

À retenir : les skills sont des fichiers CLAUDE.md chargés automatiquement - ils enseignent vos conventions à Claude Code sans effort répété.

Comment orchestrer des subagents dans Claude Code ?

Les subagents sont des instances autonomes de Claude lancées par l'agent principal via l'outil Task. Chaque subagent dispose de son propre contexte et de ses propres outils. Utilisez les subagents pour paralléliser des tâches indépendantes comme la recherche et l'implémentation.

Types de subagents disponibles

Syntaxe d'appel d'un subagent

// Exemple conceptuel d'orchestration subagent
// Claude utilise automatiquement Task en interne
Task({
  subagent_type: "Explore",
  prompt: "Trouve toutes les routes API qui utilisent l'authentification",
  description: "Recherche routes auth"
})

En pratique, un subagent Explore analyse un dépôt de 50 000 fichiers en 15 à 30 secondes. Vous pouvez lancer jusqu'à 5 subagents en parallèle pour maximiser la performance.

Concrètement, les subagents protègent le contexte principal : un subagent de recherche qui lit 200 fichiers ne pollue pas la fenêtre de contexte de l'agent parent.

Pour comprendre comment gérer efficacement le contexte entre agent principal et subagents, consultez le guide de gestion du contexte.

À retenir : les subagents parallélisent le travail et protègent votre fenêtre de contexte - utilisez Explore pour la recherche et general-purpose pour l'implémentation.

Quels hooks permettent d'automatiser les workflows de manière déterministe ?

Les hooks sont des commandes shell exécutées automatiquement en réponse à des événements Claude Code. Contrairement aux skills (probabilistes), les hooks sont déterministes : ils s'exécutent à chaque fois, sans exception. Configurez vos hooks dans le fichier .claude/settings.json.

Configuration des hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "tool": "Edit",
        "command": "npx eslint --fix $CLAUDE_FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "tool": "Bash",
        "command": "echo 'Commande Bash exécutée: $CLAUDE_COMMAND'"
      }
    ],
    "UserPromptSubmit": [
      {
        "command": "echo 'Prompt reçu à $(date)' >> ~/.claude/prompt-log.txt"
      }
    ]
  }
}

Événements hook disponibles

les hooks PostToolUse réduisent de 80 % les allers-retours de correction de linting. Lancez un test rapide en ajoutant un hook de logging pour vérifier que la configuration fonctionne.

La gestion des permissions lors de l'exécution des hooks est détaillée dans l'aide-mémoire permissions et sécurité. Pour combiner hooks et commandes Git, consultez l'aide-mémoire intégration Git.

À retenir : les hooks garantissent une exécution déterministe - utilisez-les pour le linting automatique, le logging et les validations obligatoires.

Comment étendre Claude Code avec des plugins et le MCP ?

Le Model Context Protocol (MCP) est le standard ouvert d'Anthropic pour connecter Claude Code à des outils externes. MCP permet d'ajouter des serveurs qui exposent des outils, des ressources et des prompts supplémentaires.

Configuration MCP

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://localhost:5432/mydb"
      }
    }
  }
}

Placez cette configuration dans .claude/settings.json (projet) ou ~/.claude/settings.json (global). En 2026, l'écosystème MCP compte plus de 150 serveurs communautaires couvrant les bases de données, les API cloud et les outils DevOps.

Pour commencer avec les exemples de commandes personnalisées, vous trouverez des configurations MCP prêtes à l'emploi.

À retenir : MCP connecte Claude Code à n'importe quel outil externe via un protocole standardisé - commencez par le serveur GitHub pour un gain immédiat.

Quels raccourcis clavier accélèrent le travail avec les commandes ?

Mémorisez ces raccourcis pour naviguer efficacement dans Claude Code. Ces combinaisons fonctionnent dans le terminal interactif de Claude Code v1.0.33.

SFEIR Institute propose la formation Claude Code sur une journée : vous y pratiquerez la création de commandes slash, la configuration de skills et l'orchestration de subagents sur des cas réels. Pour aller plus loin, la formation Développeur Augmenté par l'IA couvre en 2 jours l'intégration complète de l'IA dans votre workflow de développement, y compris les hooks et les pipelines CI/CD augmentés.

Consultez l'aide-mémoire d'installation pour vérifier que votre environnement est correctement configuré avant de personnaliser vos commandes.

À retenir : /compact et Échap sont les deux raccourcis les plus utiles au quotidien - le premier gère le contexte, le second interrompt une génération non pertinente.

Comment structurer un projet avec commandes, skills et hooks combinés ?

Voici l'arborescence recommandée pour un projet qui exploite pleinement l'extensibilité de Claude Code. Organisez vos fichiers selon cette structure dès le premier jour.

mon-projet/
├── .claude/
│   ├── CLAUDE.md                  # Skill projet (conventions globales)
│   ├── settings.json              # Hooks + MCP
│   └── commands/
│       ├── review.md              # /custom:review
│       ├── test.md                # /custom:test
│       ├── deploy.md              # /custom:deploy
│       └── changelog.md           # /custom:changelog
├── src/
│   └── components/
│       └── .claude/
│           └── CLAUDE.md          # Skill répertoire (patterns React)
└── ...

Concrètement, cette structure ajoute moins de 5 Ko à votre dépôt et se versionne avec Git comme n'importe quel fichier de configuration. Le fichier settings.json pèse en moyenne 200 à 500 octets.

Pour maîtriser vos premières conversations avec cette configuration en place, la courbe d'apprentissage tombe à moins de 30 minutes.

Si vous souhaitez approfondir ces techniques avec des exercices pratiques, la formation Développeur Augmenté par l'IA – Avancé de SFEIR consacre une demi-journée à la création de workflows personnalisés avec skills, hooks et subagents.

À retenir : regroupez commandes, skills et hooks dans .claude/ à la racine - versionnez tout avec Git pour partager les conventions avec votre équipe.

Quelles sont les erreurs à éviter avec les commandes personnalisées ?

Vérifiez ces points avant de déployer vos commandes custom en équipe. Les erreurs les plus fréquentes concernent le nommage des fichiers et la syntaxe des variables.

• Erreur de nommage : le fichier mon-review.md crée la commande /custom:mon-review, pas /review
• Variable oubliée : $ARGUMENTS est sensible à la casse - $arguments ne fonctionne pas
• Fichier trop long : un prompt de plus de 2 000 mots consomme du contexte inutilement - visez 100 à 300 mots
• Hook qui bloque : un hook PreToolUse qui échoue (exit code ≠ 0) bloque l'outil - testez toujours en isolation d'abord
• MCP sans token : oublier la variable d'environnement GITHUB_TOKEN fait échouer silencieusement le serveur MCP
• Skill contradictoire : deux fichiers CLAUDE.md avec des instructions opposées créent un comportement imprévisible

Le guide complet des erreurs courantes détaille chacun de ces cas avec les solutions associées. En pratique, 90 % des problèmes se résolvent en vérifiant le chemin du fichier et la syntaxe de $ARGUMENTS.

À retenir : testez chaque commande en isolation avant de la partager - un fichier mal nommé ou un hook défaillant peut bloquer tout le workflow.