bmad-help

Analyzes workflow state and recommends the next BMad skill to invoke.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/shaahy/quicknav-desktop --skill bmad-help-shaahy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/shaahy/quicknav-desktop/tree/main/A%20%E6%95%99%E7%A8%8B%E9%9B%86%E5%90%88/BMAD-METHOD%E6%8A%80%E8%83%BD%E9%80%9F%E6%9F%A5/source-v6.10.0/src/core-skills/bmad-help
Command: npx skills add https://github.com/shaahy/quicknav-desktop --skill bmad-help-shaahy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with the BMad framework, users often lose track of which phase they are in, which steps are complete, and which skill to run next. This Skill reads the installed module catalog and existing output artifacts to orient the user and recommend the next action. ## Core Features & Use Cases - Workflow Orientation: Detects completed steps by matching output files against the bmad-help.csv catalog and resolves configuration via the resolve_config.py script. - Next-Step Recommendation: Suggests optional and required next skills with menu codes, invocation syntax, and args, ordered by phase and sequencing rules. - Grounded Q&A: Answers general BMad questions using registered module documentation sources (e.g., llms.txt) instead of guessing. - Use Case: A user finishes a PRD and asks "what do I do next in BMad?" The Skill detects the completed planning artifacts and recommends the architecture skill with its exact invocation command. ## Quick Start Ask the assistant where you are in your BMad workflow and what skill to run next.

Frequently Asked Questions about bmad-help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I know what to do next in BMad?▼

Invoke the bmad-help skill, which reads the bmad-help.csv catalog and scans your output directories for completed artifacts. It then recommends the next optional and required skills with their menu codes and invocation syntax.

How does BMad detect which workflow steps are complete?▼

Completion is detected by searching resolved output-location paths for files matching the outputs patterns defined in the catalog. Users can also state completion explicitly, or it may be evident from the conversation context.

Can bmad-help answer general questions about BMad modules?▼

Yes, catalog rows with _meta in the skill column point to module documentation sources such as llms.txt files. The skill fetches these remote or local documents to ground answers about module capabilities.

What configuration does bmad-help need to work?▼

It runs resolve_config.py with uv and Python 3.11 to merge config.toml, config.user.toml, and custom config files. The merged JSON provides output locations, communication language, and project knowledge paths.

Are BMad phase requirements mandatory to follow?▼

Only items marked required=true in the catalog act as gates before later phases. Phases without required items are optional, and preceded-by or followed-by fields are soft sequencing suggestions rather than hard gates.