bmad-help

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

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-help-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-help
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-help-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working through the BMad methodology often lose track of which phase they are in, which steps are complete, and which skill to invoke 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 Position Detection: Scans resolved output locations for artifact files matching catalog patterns to infer which BMad steps are already complete. - Next-Step Recommendation: Uses phase ordering, after/before dependencies, and required gates from the bmad-help.csv catalog to suggest optional and required next skills with menu codes and invocation args. - Grounded Q&A: Fetches module documentation sources (e.g., llms.txt) registered in the catalog to answer general questions about a module. - Use Case: A user finishes a product brief and asks "what should I do next in BMad?" The Skill detects the completed brief, identifies the PRD as the next required step, and offers to launch bmad-create-prd immediately. ## Quick Start Ask the agent "where am I in my BMad workflow and what should I do next?" to get an oriented recommendation.

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, which reads the bmad-help.csv catalog and scans your output folders for completed artifacts. It then recommends the next required or optional skill with its menu code and invocation command.

How does BMad track which workflow steps are completed?▼

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, and the skill fuzzy-matches found files to catalog rows.

Can bmad-help answer general questions about a BMad module?▼

Yes. Catalog rows with _meta in the skill column point to module documentation sources such as llms.txt files. The skill fetches these remote sources to ground answers that do not map to a specific skill.

What happens if a required BMad phase step is not finished?▼

Items marked required=true in the catalog act as gates. The skill will surface the next required item after any optional recommendations, making clear which step must complete before later phases can meaningfully proceed.

Does bmad-help run the recommended skill automatically?▼

No. It presents the recommendation with the skill name, menu code, and args, and offers to run it when a single skill is the clear next step. It recommends running each skill in a fresh context window.