Skills

Les skills sont des prompts pré-construits qui chargent des agents, exécutent des workflows ou lancent des tâches dans votre IDE. L’installateur BMad les génère à partir de vos modules installés au moment de l’installation. Si vous ajoutez, supprimez ou modifiez des modules ultérieurement, relancez l’installateur pour garder les skills synchronisés (voir Dépannage).

BMad offre deux façons de démarrer un travail, chacune ayant un usage différent.

Mécanisme	Comment l’invoquer	Ce qui se passe
Skill	Tapez le nom du skill (ex. `bmad-help`) dans votre IDE	Charge directement un agent, exécute un workflow ou lance une tâche
Déclencheur du menu agent	Chargez d’abord un agent, puis tapez un code court (ex. `DS`)	L’agent interprète le code et démarre le workflow correspondant tout en préservant son persona

Les déclencheurs du menu agent nécessitent une session agent active. Utilisez les skills lorsque vous savez quel workflow vous voulez. Utilisez les déclencheurs lorsque vous travaillez déjà avec un agent et souhaitez changer de tâche sans quitter la conversation.

Comment les skills sont générés

Lorsque vous exécutez npx bmad-method install, l’installateur lit les manifests de chaque module sélectionné et écrit un skill par agent, workflow, tâche et outil. Chaque skill est un répertoire contenant un fichier SKILL.md qui indique à l’IA de charger le fichier source correspondant et de suivre ses instructions.

L’installateur utilise des modèles pour chaque type de skill :

Type de skill	Ce que fait le fichier généré
Lanceur d’agent	Charge le fichier de persona de l’agent, active son menu et reste en caractère
Skill de workflow	Charge la configuration du workflow et suit ses étapes
Skill de tâche	Charge un fichier de tâche autonome et suit ses instructions
Skill d’outil	Charge un fichier d’outil autonome et suit ses instructions

Emplacement des fichiers de skill

L’installateur écrit les fichiers de skill dans un répertoire spécifique à l’IDE à l’intérieur de votre projet. Le chemin exact dépend de l’IDE que vous avez sélectionné lors de l’installation.

IDE / CLI	Répertoire des skills
Claude Code	`.claude/skills/`
Cursor	`.cursor/skills/`
Windsurf	`.windsurf/skills/`
Autres IDE	Consultez la sortie de l’installateur pour le chemin cible

Chaque skill est un répertoire contenant un fichier SKILL.md. Par exemple, une installation Claude Code ressemble à :

.claude/skills/
├── bmad-help/
│   └── SKILL.md
├── bmad-create-prd/
│   └── SKILL.md
├── bmad-analyst/
│   └── SKILL.md
└── ...

Le nom du répertoire détermine le nom du skill dans votre IDE. Par exemple, le répertoire bmad-analyst/ enregistre le skill bmad-analyst.

Comment découvrir vos skills

Tapez le nom du skill dans votre IDE pour l’invoquer. Certaines plateformes nécessitent d’activer les skills dans les paramètres avant qu’ils n’apparaissent.

Exécutez bmad-help pour obtenir des conseils contextuels sur votre prochaine étape.

Catégories de skills

Skills d’agent

Les skills d’agent chargent une persona¹ IA spécialisée avec un rôle défini, un style de communication et un menu de workflows. Une fois chargé, l’agent reste en caractère et répond aux déclencheurs du menu.

Exemple de skill	Agent	Rôle
`bmad-analyst`	Mary (Analyste)	Brainstorming de projets, recherche, création de briefs
`bmad-architect`	Winston (Architecte)	Conçoit l’architecture système
`bmad-ux-designer`	Sally (Designer UX)	Crée les designs UX
`bmad-tech-writer`	Paige (Rédacteur Technique)	Documente les projets, rédige des guides, génère des diagrammes

Consultez Agents pour la liste complète des agents par défaut et leurs déclencheurs.

Skills de workflow

Les skills de workflow exécutent un processus structuré en plusieurs étapes sans charger d’abord une persona d’agent. Ils chargent une configuration de workflow et suivent ses étapes.

Exemple de skill	Objectif
`bmad-create-prd`	Créer un PRD²
`bmad-create-architecture`	Concevoir l’architecture système
`bmad-create-epics-and-stories`	Créer des epics et des stories
`bmad-dev-story`	Implémenter une story
`bmad-code-review`	Effectuer une revue de code
`bmad-quick-dev`	Flux rapide unifié — clarifier l’intention, planifier, implémenter, réviser, présenter

Consultez la Carte des workflows pour la référence complète des workflows organisés par phase.

Skills de tâche et d’outil

Les tâches et outils sont des opérations autonomes qui ne nécessitent pas de contexte d’agent ou de workflow.

BMad-Help : Votre guide intelligent

bmad-help est votre interface principale pour découvrir quoi faire ensuite. Il inspecte votre projet, comprend les requêtes en langage naturel et recommande la prochaine étape requise ou optionnelle en fonction de vos modules installés.

Autres tâches et outils principaux

Le module principal inclut 11 outils intégrés — revues, compression, brainstorming, gestion de documents, et plus. Consultez Outils principaux pour la référence complète.

Convention de nommage

Tous les skills utilisent le préfixe bmad- suivi d’un nom descriptif (ex. bmad-analyst, bmad-create-prd, bmad-help). Consultez Modules pour les modules disponibles.

Dépannage

Les skills n’apparaissent pas après l’installation. Certaines plateformes nécessitent d’activer explicitement les skills dans les paramètres. Consultez la documentation de votre IDE ou demandez à votre assistant IA comment activer les skills. Vous devrez peut-être aussi redémarrer votre IDE ou recharger la fenêtre.

Des skills attendus sont manquants. L’installateur génère uniquement les skills pour les modules que vous avez sélectionnés. Exécutez à nouveau npx bmad-method install et vérifiez votre sélection de modules. Vérifiez que les fichiers de skill existent dans le répertoire attendu.

Des skills d’un module supprimé apparaissent encore. L’installateur ne supprime pas automatiquement les anciens fichiers de skill. Supprimez les répertoires obsolètes du répertoire de skills de votre IDE, ou supprimez tout le répertoire de skills et relancez l’installateur pour obtenir un ensemble propre.

Glossaire

Persona : dans le contexte de BMad, une persona désigne un agent IA avec un rôle défini, un style de communication et une expertise spécifiques (ex. Mary l’analyste, Winston l’architecte). Chaque persona garde son “caractère” pendant les interactions. ↩
PRD (Product Requirements Document) : document de référence qui décrit les objectifs du produit, les besoins utilisateurs, les fonctionnalités attendues, les contraintes et les critères de succès, afin d’aligner les équipes sur ce qui doit être construit et pourquoi. ↩