bmad-help

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-help-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-help
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-help-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Users working inside the BMad framework 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 project artifacts to orient the user and answer BMad-related questions. ## Core Features & Use Cases - Workflow Orientation: Detects the current module and phase by scanning output artifacts against the bmad-help.csv catalog. - Next-Step Recommendation: Suggests optional and required next skills with menu codes, invocation context, and args, and offers to run a clear next step immediately. - Grounded Q&A: Answers general BMad questions using registered module documentation sources such as llms.txt files. - Use Case: A user finishes a PRD and asks "what do I do next?" The skill checks completed outputs, identifies the next required gate, and presents the exact skill and command to continue. ## Quick Start Ask the assistant where you are in your BMad workflow and what skill you should 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?

Ask for BMad help and the skill reads the bmad-help.csv catalog plus your output artifacts to detect completed steps. It then presents optional items first, followed by the next required skill with its menu code and invocation context.

How does BMad help detect which steps are already completed?

It resolves output-location paths from the merged BMad config and searches for files matching the outputs patterns in the catalog. Found files are fuzzy-matched to catalog rows, and explicit user statements also count as completion.

Can BMad help answer general questions about a 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 is the difference between required and optional BMad skills?

Rows marked required=true are gates that must complete before later phases are meaningful. Phases without required items are optional, and the skill clearly labels which recommendations are optional versus required.

Why does BMad help recommend running skills in a fresh context window?

Each skill loads its own instructions and resources into context, so a fresh window avoids contamination from prior conversation state. This keeps recommendations and executions consistent with the skill's intended workflow.