bmad-help

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

Updated Sep 4, 2026
One-click install
npx skills add https://github.com/Joao-Victor-Medeiros/save-sc --skill bmad-help-joao-victor-medeiros
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/Joao-Victor-Medeiros/save-sc/tree/main/.agents/skills/bmad-help
Command: npx skills add https://github.com/Joao-Victor-Medeiros/save-sc --skill bmad-help-joao-victor-medeiros

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working in a BMad project often lose track of which module and phase they are in, what has been completed, and which skill to run next. This Skill reads the installed skill catalog, resolved configuration, and existing output artifacts to orient the user and answer BMad-related questions. ## Core Features & Use Cases - Workflow Position Detection: Scans resolved output locations for artifact files and fuzzy-matches them to catalog rows to infer which steps are complete or in progress. - Next-Step Recommendation: Uses phase, preceded-by, followed-by, and required fields from the bmad-help.csv catalog to recommend optional and required next skills with menu codes and invocation args. - Grounded Q&A: Fetches module documentation referenced by _meta catalog rows to answer general questions about BMad modules without fabricating project details. - Use Case: A user returns to a BMad project after a week and asks "what should I do next?" The Skill detects the completed PRD artifact, identifies the next required skill, and offers to launch it immediately. ## 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 find out what to do next in a BMad project?▼

Ask for BMad help or what to do next. The Skill reads the bmad-help.csv catalog, checks resolved output locations for completed artifacts, and recommends the next optional and required skills with their menu codes and invocation commands.

How does BMad help detect which workflow steps are completed?▼

It searches resolved output-location paths for files matching the outputs patterns in the catalog and fuzzy-matches them to skill rows. It inspects artifacts for explicit completion markers, since a draft file only proves a skill started, not that it finished.

Can BMad help answer general questions about a module?▼

Yes. Catalog rows with _meta in the skill column carry a URL or path to the module's documentation. The Skill fetches those sources to ground answers about modules rather than relying on assumptions.

What configuration does BMad help rely on?▼

It runs the resolve_config.py script with uv to merge _bmad/config.toml, config.user.toml, and custom config files. The merged JSON provides output-location variables, communication language, and the project knowledge path.

What are the limitations of BMad workflow completion detection?▼

File presence alone does not prove completion, since artifacts may be drafts. When completion cannot be determined reliably, the Skill says so and asks the user instead of recommending advancement based on file existence.