bmad-workflow-builder

Builds, edits, and analyzes AI skills and workflows through a goal-driven loop.

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-workflow-builder-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-workflow-builder
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-workflow-builder
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-workflow-builder-pastasus

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 half-formed idea into a lean, outcome-driven AI skill is hard: most generated skills ship bloated instructions, generic procedure, and no evidence they beat the bare model. This Skill guides the full lifecycle of building, editing, and quality-analyzing skills so every line earns its place. ## Core Features & Use Cases - Build and Edit Flow: Scaffolds new skills from a template via init_skill.py, hardens vague ideas through questioning, captures decisions in a memlog, and applies an earn-its-place test to every line. - Analyze Scanners: Runs deterministic pre-pass scripts (token metrics, workflow integrity, frontmatter lint) plus LLM lenses, then renders a self-contained HTML and Markdown report with severity-graded findings. - Customization Surface: Optionally emits a customize.toml with three-layer merge rules (base, team, personal overrides) for activation hooks, persistent facts, and output paths. - Use Case: Point it at an existing skill and say "analyze" to get a graded HTML report on leanness, structure, and frontmatter conformance, or describe a new workflow idea and have it scaffolded, eval-tested, and linted before handoff. ## Quick Start Ask the assistant to build a new skill from your idea, or give it the path to an existing skill 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 build a new AI skill from an idea?

Invoke the skill with a description of your idea and it runs a build loop: hardening the concept, scaffolding with init_skill.py, drafting a minimal SKILL.md, and testing on real input. Decisions are captured in a memlog so sessions can resume.

How do I quality-check an existing skill?

Point the skill at the target skill's path with the word analyze. It runs deterministic pre-pass scanners for token budgets, frontmatter validity, and workflow integrity, then LLM lenses, and renders a graded HTML report.

What is the SKILL.md token budget enforced by the builder?

The default desired budget is 2000 tokens with a hard cap of 3000, measured with tiktoken cl100k_base via count_tokens.py. Over-budget skills are fixed by lifting sections into references files until back under budget.

Does the builder support team and personal customization overrides?

Yes, when customization is accepted during a build it emits a customize.toml base file. Team and personal TOML overrides merge over it at activation, with scalars overriding and arrays appending.

What happens when a built skill fails the lint gate?

The handoff runs quick_validate.py, path-standards, and script scanners, fixing high or critical findings and re-running until clear. After three failed fix attempts it stops and surfaces the issue instead of shipping.