skills.rest
watchthelight
watchthelightCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bmad-help

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

Updated Sep 3, 2026
Search Tags:#workflow#catalog#recommendation#help#orientation#bmad#phase detection
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-help-watchthelight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-help
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-help-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working with the BMad framework often lose track of which module, phase, or step they are in and which skill to invoke next. This Skill reads the installed skill catalog, configuration, and existing output artifacts to orient the user and recommend the next action. ## Core Features & Use Cases - Workflow Position Detection: Scans resolved output paths for artifact files matching catalog patterns to infer which BMad steps are already 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: Fetches module documentation (e.g., llms.txt) registered in the catalog to answer general questions about a module without fabricating project details. - Use Case: A user asks "what should I do next in BMad?" after finishing a PRD; the Skill detects the completed PRD artifact, identifies the next required phase item, 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 know what to do next in a BMad workflow?▼

Invoke the bmad-help skill, which scans your output artifacts against the bmad-help.csv catalog to detect completed steps. It then recommends the next optional and required skills with their menu codes and invocation commands.

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, or it may be evident from the current conversation.

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

The catalog is an assembled manifest of all installed module skills with columns for phase, sequencing (preceded-by, followed-by), required gates, output locations, and descriptions. It drives routing, ordering, and completion detection for recommendations.

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

Yes. Catalog rows with _meta in the skill column carry a URL or path to the module's documentation, such as an llms.txt file. The skill fetches these sources to ground answers instead of fabricating module details.

Why does bmad-help recommend running skills in a fresh context window?▼

Each BMad skill is designed to operate with full context dedicated to its own task. Starting in a fresh window prevents leftover conversation state from interfering with the next skill's instructions and outputs.

Related Skills

Explore More Product & Management Skills→
bmad-code-orgbmad-code-org
52.5k

bmad-help

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

Official
Intermediate
Asygnuz-S-A-SAsygnuz-S-A-S

bmad-help

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

Official
Intermediate
ImaginerLabsImaginerLabs

bmad-help

Clarify user position and next steps in BMad workflows using module documentation.

Official
Intermediate
Rinzler78Rinzler78
1

bmad-help

Analyze BMad workflow state to recommend the next skill or answer module help requests.

Community
Intermediate