bmad-workflow-builder

Builds, edits, and analyzes AI agent skills and workflows using BMad conventions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tiktoken, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Turning a rough idea into a well-structured AI agent skill is hard: prompts tend to bloat with unnecessary scaffolding, lack eval coverage, and drift from organizational standards. This Skill guides the creation, editing, and quality analysis of SKILL.md-based agent skills through a goal-driven build loop with deterministic linting and token budgets. ## Core Features & Use Cases - Build and Edit Flow: Scaffolds new skills from a template, hardens vague ideas through structured questioning, captures decisions in a memlog, and applies an earn-its-place leanness test to every line. - Analyze Mode: Runs deterministic pre-pass scanners (prompt metrics, workflow integrity) plus LLM lenses over a skill and renders a self-contained HTML or Markdown findings report. - Customization Surface: Emits an optional customize.toml with three-layer merge rules (base, team, personal overrides) for activation hooks, persistent facts, and output paths. - Use Case: A platform engineer wants to codify a runbook as an agent skill. They invoke the builder, which pressure-tests the idea, scaffolds the skill with init_skill.py, runs it on real input, lints it, and ships it under the token budget. ## Quick Start Ask the agent to build a new skill from your idea, or point it at an existing skill directory and ask it to analyze or edit that skill.

Frequently Asked Questions about bmad-workflow-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new AI agent skill with a SKILL.md file?

Invoke the builder with a description of your idea; it hardens the concept through questions, then scaffolds the directory with init_skill.py, which normalizes the name to kebab-case and writes SKILL.md from a template. You then draft the minimal version and test it on real input.

How do I quality-check an existing agent skill?

Point the builder at the skill directory and ask it to analyze. It runs deterministic pre-pass scanners for prompt metrics and workflow integrity, then applies LLM lenses and renders a self-contained HTML report with severity-graded findings.

What is the SKILL.md token budget for agent skills?

The default desired budget is 2000 tokens with a hard limit of 3000, measured with tiktoken cl100k_base via count_tokens.py. Skills over budget must lift sections into references/ files until they return under the limit.

Does the builder support team-level customization of built skills?

Yes, when customization is accepted during the build, the skill ships a customize.toml with universal defaults. Team and personal override files merge over it at activation, with scalars overriding and arrays appending.

What Python dependencies does the workflow builder need?

The scripts require Python 3.9 or later, and tiktoken is the only third-party dependency, used for accurate token counting. When tiktoken is absent, the scripts fall back to a character-based estimate so they still run.