bmad-help

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

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/LinCie/bearuang --skill bmad-help-lincie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-help
Source: https://github.com/LinCie/bearuang/tree/main/.opencode/skills/bmad-help
Command: npx skills add https://github.com/LinCie/bearuang --skill bmad-help-lincie

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 files, and existing output artifacts to orient the user and recommend the next action. ## Core Features & Use Cases - Workflow Position Detection: Reads the bmad-help.csv catalog, config.yaml files, and output artifacts to determine which phases and skills are already completed. - Next-Step Recommendation: Presents optional and required next skills with menu codes, skill names, action context, and args, ordered by dependency rules. - Use Case: A user finishes a PRD and asks "what should I do next in BMad?" The Skill detects the completed planning artifacts, identifies the next required phase, and offers to launch the appropriate skill immediately. ## Quick Start Ask the assistant "bmad help, what should I do next?" to get an oriented recommendation based on your current project state.

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 installed skill catalog and your existing output artifacts to detect completed steps. It then recommends the next optional and required skills with menu codes and invocation details.

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 bmad-help.csv catalog. Users can also state completion explicitly or it may be evident from the conversation.

What is the bmad-help.csv catalog file?▼

It is an assembled manifest of all installed module skills with columns for module, skill, menu code, description, action, args, phase, dependencies, required flags, and output locations. The skill uses it to determine ordering and next steps.

Can BMad phases be skipped if they are optional?▼

Yes. A phase with no required items is entirely optional and will be recommended but clearly marked as skippable. Only items flagged required=true must complete before proceeding to later phases.

What happens if the active BMad module is ambiguous?▼

The skill asks the user to clarify rather than guessing. This prevents recommending skills from the wrong module when multiple modules could match the current context.