bmad-help

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

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-help-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.agent/skills/bmad-help
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-help-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working with the BMad framework often lose track of which phase they are in, which steps are completed, and which skill to run next, leading to confusion and stalled workflows. ## Core Features & Use Cases - Workflow Orientation: Reads the bmad-help.csv catalog, config files, and output artifacts to determine the current module, phase, and completed steps. - Next-Step Recommendation: Suggests optional and required next skills with menu codes, invocation syntax, and args, and offers to run a clear next step immediately. - General Q&A: Answers broader BMad questions by fetching module documentation sources registered in the catalog. - Use Case: A user finishes a PRD and asks "what do I do next?" — the skill detects the completed PRD artifact, identifies the next required planning skill, and offers to launch it in a fresh context. ## Quick Start Ask the assistant where you are in your BMad workflow and what skill you should 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 a BMad workflow?▼

Invoke the bmad-help skill and ask what to do next. It reads the bmad-help.csv catalog and scans resolved output paths for completed artifacts, then recommends the next optional and required skills with menu codes and invocation syntax.

How does BMad detect which workflow steps are completed?▼

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

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

Yes. Catalog rows with _meta in the skill column carry a URL or path to module documentation such as llms.txt. The skill fetches these sources to ground answers about the module when the question does not map to a specific skill.

What is the difference between required and optional BMad skills?▼

Skills marked required=true in the catalog must complete before later phases can meaningfully proceed. A phase with no required items is entirely optional, and bmad-help presents optional items first while clearly marking the next required step.

Why should each BMad skill run in a fresh context window?▼

The skill's constraints recommend running each BMad skill in a fresh context window so prior conversation state does not interfere with the new skill's instructions and artifact handling.