bmad-help

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

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-help-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-help
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-help-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working through a BMad workflow 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 and fuzzy-matches them to catalog rows to infer which skills have started or completed. - Next-Step Recommendation: Uses phase, preceded-by, followed-by, and required fields from the bmad-help.csv catalog to suggest optional and required next skills with menu codes and invocation args. - Grounded Q&A: Answers general BMad questions by fetching module documentation referenced in catalog meta rows and reading configured project knowledge files. - Use Case: A user returns to a project after a week and asks "what should I do next in BMad?" The Skill inspects existing planning artifacts, determines the PRD is complete but the architecture step is not, and offers to launch the architecture skill immediately. ## Quick Start Ask the assistant "where am I in my BMad workflow and what should I do next?" to get an oriented status summary and a recommended next skill.

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 directories for existing artifacts. It then recommends the next optional and required skills with their menu codes and invocation commands.

How does BMad detect which workflow steps are already completed?

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

What is the bmad-help.csv catalog file used for?

The bmad-help.csv file is an assembled manifest of all installed module skills with columns for phase, sequencing, required gates, and output locations. The help skill uses it to determine ordering, gating, and routing between skills.

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 and uses them, plus any configured project_knowledge files, to ground answers instead of fabricating details.

Why does BMad help say completion cannot be determined?

File presence alone does not prove a skill finished, and artifacts may be drafts without finalization markers. When evidence is ambiguous, the skill asks the user to confirm completion rather than recommending advancement on unreliable signals.