Skip to content
cccskills
FreePublished on GitHub

bmad

Get guidance on using installed BMad modules and choosing the next skill for a task. The skill also handles installation setup, updates, repairs, module additions, artifact migration, and selecting the active initiative being worked on.

OriginalShow the original 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.

See how to install

Good for

  • Choosing where to start or what to do next
  • Setting up or repairing a BMad installation
  • Adding modules or migrating project artifacts
  • Checking or switching the active initiative

Files included (29)

  • SKILL.md2.4 KB
  • assets/config.template.toml87 B
  • bmod.toml84 B
  • references/help.md2.0 KB
  • references/initiative.md1.2 KB
  • references/migrate.md2.3 KB
  • references/setup.md5.6 KB
  • scripts/config_utils.py4.0 KB
  • scripts/knowledge.py18.5 KB
  • scripts/memlog.py11.7 KB
  • scripts/migrate_v6.py44.6 KB
  • scripts/render_skill.py30.8 KB
  • scripts/resolve_config.py2.3 KB
  • scripts/resolve_customization.py5.7 KB
  • scripts/roster.py8.9 KB
  • scripts/setup_check.py5.6 KB
  • scripts/setup.py97.6 KB
  • scripts/stamp_release.py5.2 KB
  • scripts/tests/test_config_utils.py3.4 KB
  • scripts/tests/test_knowledge_migrations.py6.7 KB
  • scripts/tests/test_memlog.py11.6 KB
  • scripts/tests/test_render_skill.py55.8 KB
  • scripts/tests/test_resolve_config.py4.3 KB
  • scripts/tests/test_resolve_customization.py7.0 KB
  • scripts/tests/test_roster.py10.5 KB
  • scripts/tests/test_setup_check.py11.0 KB
  • scripts/tests/test_stamp_release.py15.0 KB
  • scripts/tests/test_validate_manifests.py24.9 KB
  • scripts/validate_manifests.py20.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

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.

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:

  1. 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.
  2. Read references/help.md and follow it.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Revisit a recent answer, plan, draft, or decision using selected critique methods. The skill offers relevant approaches, explains what they reveal, and proposes improvements that are applied only after the user accepts them.

  • Examining assumptions in a plan
  • Reviewing a draft from several perspectives
  • Exploring failure risks before a launch
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

Work with Mary, a business analyst persona, to research markets, examine competitors, and clarify requirements. Use evidence-based discussion to turn vague needs into concrete specifications that can guide the next steps of a project.

  • Researching a market before planning a project
  • Examining competitors to inform a business idea
  • Turning vague requests into concrete requirements
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

Turn product requirements and user experience plans into technical architecture with Winston, a system architect persona. Discuss technology choices and their trade-offs, with an emphasis on established tools, developer productivity, and designs that can be implemented.

  • Turning product requirements into a technical design
  • Discussing trade-offs between technology choices
  • Reviewing architecture with developer productivity in mind
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

bmad-agent-dev

FreeSummary

Implement approved development stories and code changes with Amelia, a senior software engineer persona. Follow a test-first process: write a failing test, make it pass, then improve the code while checking every acceptance criterion.

  • Implementing an approved development story
  • Making code changes with a test-first process
  • Checking implementation against acceptance criteria
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

bmad-agent-pm

FreeSummary

Work with John, a product manager persona, to clarify requirements through user interviews and stakeholder alignment. Turn a product vision into a PRD, a product requirements document, and small, validated increments for development.

  • Turning a product idea into a PRD
  • Discovering requirements through user interviews
  • Aligning stakeholders on product requirements
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

bmad-agent-po

FreeSummary

Turn ideas, briefs, product requirements, or meeting notes into actionable tickets with Sofia, the Product Owner. Break large initiatives into smaller work items, refine requirements, review board status, validate ticket structure, and replan when requirements change.

  • Turn ideas and notes into ticket requirements
  • Break large initiatives into smaller work items
  • Refine tickets and review readiness
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 18, 2026

See all skills by bmad-code-org

Report a problem with this skill