bmad-help

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

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-help-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-help
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-help-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with the BMad framework, it is easy to lose track of which phase you are in, which steps are complete, and which skill to invoke next. This Skill reads your project state and gives a grounded, specific answer instead of a generic catalog dump. ## Core Features & Use Cases - Workflow orientation: Reads the bmad-help.csv catalog, merged config, and existing output artifacts to determine which module and phase you are in and what is already done. - Next-step recommendation: Presents optional and required next skills with menu codes, skill names, action context, and args, and offers to run the clear next step immediately. - Grounded Q&A: Fetches module documentation sources (e.g., llms.txt) registered in the catalog to answer general BMad questions without fabricating details. - Use Case: You return to a BMad project after a week and ask "what should I do next?" — the Skill detects your completed PRD, identifies the architecture step as next, and offers to launch it in a fresh context. ## 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 reads the bmad-help.csv catalog and scans resolved output paths for completed artifacts. It then recommends optional and required next skills with menu codes and invocation context.

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

Completion is detected by searching resolved output-location paths for file patterns listed in the catalog's outputs column, then fuzzy-matching found files to catalog rows. Explicit user statements or conversation context can also indicate completion.

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 phase ordering and next-step recommendations.

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 instead of fabricating module-specific details.

Are BMad phase sequences strictly enforced?▼

No. The preceded-by and followed-by fields are soft suggestions, not hard gates. Only rows marked required=true act as gates that must complete before meaningfully proceeding to later phases.