agentleFS
Brumm-LabsBrumm-Labs/kb-agents/.claude/skills/bmad-workflow-builder/SKILL.md

bmad-workflow-builder

Skill1 starsChanged 7 months agoMITView on GitHub

Builds, converts, and analyzes workflows and skills. Use when the user requests to "build a workflow", "modify a workflow", "quality check workflow", "analyze skill", or "convert a skill".

11 other projects use a version of this, 4 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use bmad-eval-runner, bmad-dev-auto and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • bmad-code-orgSkill

    bmad-eval-runner

    Run a skill's evals and report results. Use when the user wants to evaluate a skill, run evals, benchmark a skill, validate triggers, optimize a description, or grade skill outputs.

    Also in 6 projects that use this

  • areesh-aliSkill

    bmad-dev-auto

    One iteration of an unattended development loop. Use when invoked by name.

    Also in 4 projects that use this

  • airclearSkill

    bmad-tea

    Enterprise Test Architecture (TEA) framework for quality engineering. Includes workflows for testing education (TEA Academy), risk-based test design, framework scaffolding, ATDD (Red-phase), CI/CD pipeline configuration, NFR (Non-functional) assessment, and quality auditing (0-100 scoring). Use for establishing or executing comprehensive testing strategies.

    Also in 4 projects that use this

  • GauravRatnawatSkill

    bmad-ux

    Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX

    Also in 5 projects that use this

  • GauravRatnawatSkill

    bmad-checkpoint-preview

    LLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "walk me through this change".

    Also in 5 projects that use this

  • DogaOztuzunSkill

    bmad-product-brief

    Create or update product briefs through guided or autonomous discovery. Use when the user requests to create or update a Product Brief.

    Also in 7 projects that use this

The file

Files
SKILL.md

Workflow & Skill Builder

Overview

This skill helps you build AI workflows and skills that are outcome-driven — describing what to achieve, not micromanaging how to get there. LLMs are powerful reasoners. Great skills give them mission context and desired outcomes; poor skills drown them in mechanical procedures they'd figure out naturally. Your job is to help users articulate the outcomes they want, then build the leanest possible skill that delivers them.

Act as an architect guide — walk users through conversational discovery to understand their vision, then craft skill structures that trust the executing LLM's judgment. The best skill is the one where every instruction carries its weight and nothing tells the LLM how to do what it already knows.

Args: Accepts --headless / -H for non-interactive execution, --convert <path-or-url> to convert an existing skill into a lean equivalent with before/after HTML comparison report, an initial description for create, or a path to an existing skill with keywords like analyze, edit, or rebuild.

Your output: A skill structure ready to integrate into a module or use standalone — from simple composable utilities to complex multi-stage workflows.

On Activation

  1. Detect user's intent. If --headless or -H is passed, or intent is clearly non-interactive, set {headless_mode}=true for all sub-prompts.
  2. Load available config from {project-root}/_bmad/config.yaml and {project-root}/_bmad/config.user.yaml (root and bmb section). If missing, and the bmad-builder-setup skill is available, let the user know they can run it at any time to configure. Resolve and apply throughout the session (defaults in parens):
    • {user_name} (default: null) — address the user by name
    • {communication_language} (default: user or system intent) — use for all communications
    • {document_output_language} (default: user or system intent) — use for generated document content
    • {bmad_builder_output_folder} (default: {project-root}/skills) — save built agents here
    • {bmad_builder_reports} (default: {project-root}/skills/reports) — save reports (quality, eval, planning) here
  3. Route by intent — see Quick Reference below.

Build Process

The core creative path — where workflow and skill ideas become reality. Through conversational discovery, you guide users from a rough vision to a complete, outcome-driven skill structure. This covers building new skills from scratch, converting non-compliant formats, editing existing ones, and rebuilding from intent.

Load references/build-process.md to begin.

Quality Analysis

Comprehensive quality analysis toward outcome-driven design. Analyzes existing skills for over-specification, structural issues, execution efficiency, and enhancement opportunities. Uses deterministic lint scripts and parallel LLM scanner subagents. Produces a synthesized report with themes and actionable opportunities.

Load references/quality-analysis.md to begin.

Convert

One-command conversion of any existing skill into a BMad-compliant, outcome-driven equivalent. Whether the input is bloated, poorly structured, or just doesn't follow BMad best practices, this path reads or fetches the original, rebuilds from intent (always headless), and generates an HTML comparison report showing the before/after — metrics, what changed and why, what survived and why it earned its place.

--convert implies headless mode. Accepts a local path or URL. The original skill provides all context needed — no interactive discovery.

Load references/convert-process.md to begin.


Skill Intent Routing Reference

IntentTrigger PhrasesRoute
Build new"build/create/design a workflow/skill/tool"Load references/build-process.md
Convert--convert path-or-urlLoad references/convert-process.md
Existing skill providedPath to existing skill, or "edit/fix/analyze"Ask the 3-way question below, then route
Quality analyze"quality check", "validate", "review workflow/skill"Load references/quality-analysis.md
Unclear—Present options and ask

When given an existing skill, ask:

  • Analyze — Run quality analysis: identify opportunities, prune over-specification, get an actionable report
  • Edit — Modify specific behavior while keeping the current approach
  • Rebuild — Rethink from core outcomes using this as reference material, full discovery process

Analyze routes to references/quality-analysis.md. Edit and Rebuild both route to references/build-process.md with the chosen intent.

Regardless of path, respect headless mode if requested.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.