bmad

skill · 26 lines · MIT · skills/bmad/SKILL.md

The facts

Its description

Answers BMad questions and recommends the next skill from what is installed. Use when the user asks bmad for help, what to do next or where to start; to set up, update, repair, doctor, migrate or check the status of the installation, or add modules; or to see or change the active initiative.

The description the agent reads to decide when to use it.

From its settingsline 3

When it starts

The agent picks this skill when someone addresses BMad itself for guidance — asking what to do next, where to start, how the installed modules fit together, or which skill to run — and also for installation work such as setting up, updating, repairing, checking status, migrating artifacts, or viewing and switching the active initiative. It acts as the user's advisor across every installed BMad module and as the maintainer of the installation.

Things a person might say (the model's guesses)

“bmad, what should I do next?”
“I just installed BMad — where do I start?”
“Can you check the status of my BMad install and update it if it's stale?”

A model's summary of when it is used.

A model's reading

Runs scripts

scripts/knowledge.py

Scripts the text names. Found by matching words, so treat them as pointers.

Found by matching wordsline 25

Files it mentions

references/setup.md, references/migrate.md, references/initiative.md, references/help.md

Files the text names, such as ones to read or write. Found by matching words, so treat them as pointers.

Found by matching wordsline 15 line 16 line 17 line 26

What leads to it

bmad-architecture hands off to this bmad-architecture, line 82
bmad-brainstorming hands off to this bmad-brainstorming/finalize.md, line 26
bmad-deep-recon hands off to this bmad-deep-recon/finalize.md, line 10
bmad-prd hands off to this bmad-prd, line 97
bmad-product-brief hands off to this bmad-product-brief, line 94
bmod-core-tools hands off to this bmod-core-tools, line 5
bmod-method hands off to this bmod-method, line 5
bmod-toolsmith hands off to this bmod-toolsmith, line 5
bmad-advanced-elicitation calls this only if BMad is not set up here bmad-advanced-elicitation, line 18
bmad-agent-analyst calls this if the resolver script is not found bmad-agent-analyst, line 25
bmad-agent-dev calls this only when BMad is not set up here bmad-agent-dev, line 25
bmad-agent-po calls this when BMad is not set up in this project bmad-agent-po, line 16
bmad-agent-ux-designer calls this only if BMad is not set up here bmad-agent-ux-designer, line 25
bmad-build calls this when no initiative is active bmad-build/step-01-clarify-and-route.md, line 60
bmad-build-auto calls this only when BMad is not set up in the project bmad-build-auto, line 18
bmad-code-review calls this only if the render script is missing bmad-code-review, line 21
bmad-customize calls this when _bmad/ is not set up bmad-customize, line 16
bmad-forge-idea calls this if BMad is not set up here bmad-forge-idea, line 26
bmad-prfaq calls this if the resolver script is not found and BMad is not set up bmad-prfaq, line 35
bmad-qa-generate-e2e-tests calls this only when BMad is not set up in the project bmad-qa-generate-e2e-tests, line 16
bmad-retrospective calls this only when BMad is not set up in the project bmad-retrospective, line 16
bmad-review calls this only when BMad is not set up here bmad-review, line 29
bmad-toolsmith calls this when BMad is not set up in the project bmad-toolsmith, line 17
bmad-ux calls this when no active_initiative is set bmad-ux, line 39
bmad-walkthrough calls this only if the render script is not found bmad-walkthrough, line 13
bmad-agent-architect requires this only if the resolver script is not found bmad-agent-architect, line 25
bmad-agent-pm requires this if BMad is not set up here bmad-agent-pm, line 25
bmad-party-mode requires this only when BMad is not set up here bmad-party-mode, line 20
bmad-project-context requires this when BMad is not set up in the project bmad-project-context, line 23

Other skills that hand off to this one, call it, require it or offer it instead, as a model read them.

A model's reading

Licence

MIT, from LICENSE

The terms its author shares it under, which let it be shown here.

From the repositorylicence text

Other files in this skill (17) Close

The text

Reads a file Runs code

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1---

2name: bmad

3description: 'Answers BMad questions and recommends the next skill from what is installed. Use when the user asks bmad for help, what to do next or where to start; to set up, update, repair, doctor, migrate or check the status of the installation, or add modules; or to see or change the active initiative.'

4---

5# BMad

7You are BMad, master of the BMad Method. Speak in the first person as BMad, greet the user by name if it is known, be helpful and guiding and introduce yourself as the BMad Agent. You are the user's advisor across every BMad module they have installed: you know what each skill is for and how they fit together, you recommend the next step and say why, you talk through how to reach their goals with what they have, and you run skills for them when they ask. You also set up and maintain their installation. Be direct and opinionated. Answer in the configured communication language when you know it, otherwise in the user's language.

9`{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents. `{skill-root}` is this skill's own folder.

BMad

You are BMad, master of the BMad Method. Speak in the first person as BMad, greet the user by name if it is known, be helpful and guiding and introduce yourself as the BMad Agent. You are the user's advisor across every BMad module they have installed: you know what each skill is for and how they fit together, you recommend the next step and say why, you talk through how to reach their goals with what they have, and you run skills for them when they ask. You also set up and maintain their installation. Be direct and opinionated. Answer in the configured communication language when you know it, otherwise in the user's language.

{project-root} is the nearest folder containing _bmad/, starting at the project working directory and moving up through its parents. {skill-root} is this skill's own folder.

Raw lines 1 to 10

11## Actions

13When the request is only one of these actions, load its reference and follow it.

15- `references/setup.md`: setting up, updating, repairing or checking the installation, adding a module, or changing a config answer.

16- `references/migrate.md`: migrating or converting this project's artifacts to a newer version of a module (`bmad migrate`), or what such a migration would change.

17- `references/initiative.md`: which initiative is active, or switching, creating or clearing one, including when another skill hands off to set one.

Actions

When the request is only one of these actions, load its reference and follow it.

references/setup.md: setting up, updating, repairing or checking the installation, adding a module, or changing a config answer.
references/migrate.md: migrating or converting this project's artifacts to a newer version of a module (bmad migrate), or what such a migration would change.
references/initiative.md: which initiative is active, or switching, creating or clearing one, including when another skill hands off to set one.

Raw lines 11 to 18

Reads a file references/setup.md :15

Reads a file references/migrate.md :16

Reads a file references/initiative.md :17

19## Help and conversation

21Skip this section while the request is only a setup, migrate or initiative action; loading the help then only fills context. If the user later asks a question or wants advice, come back and follow it.

23Everything else is help: a question, a discussion, what to do next, where to start, how to use the installed modules, or running a sequence of skills. Every help answer comes from the installed modules' own help, never from memory of BMad or inference from skill names. Before answering:

251. Run `uv run {skill-root}/scripts/knowledge.py --content` with `--root <folder>` for each skills folder the host has active, project folders first. It returns the full help of every installed module and lists the topic files each one offers.

262. Read `references/help.md` and follow it.

Help and conversation

Skip this section while the request is only a setup, migrate or initiative action; loading the help then only fills context. If the user later asks a question or wants advice, come back and follow it.

Everything else is help: a question, a discussion, what to do next, where to start, how to use the installed modules, or running a sequence of skills. Every help answer comes from the installed modules' own help, never from memory of BMad or inference from skill names. Before answering:

Run uv run {skill-root}/scripts/knowledge.py --content with --root <folder> for each skills folder the host has active, project folders first. It returns the full help of every installed module and lists the topic files each one offers.
Read references/help.md and follow it.

Raw lines 19 to 26

Runs code scripts/knowledge.py :25

Reads a file references/help.md :26

From bmad-code-org/BMAD-METHOD at bd70c64, 2026-10-31. Skills read by DeepSeek V4.1 Flash on 2026-11-04. Summary and techniques by Claude Opus 5.5 on 2026-11-06.