Agent skill

Bmad Workflow Builder

by redhat-cop in redhat-cop/vault-config-operator

Builds, converts, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator.

Apache-2.0Auto-check passed

Install Bmad Workflow Builder

skills CLI
$ npx skills add redhat-cop/vault-config-operator --skill bmad-workflow-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install redhat-cop/vault-config-operator bmad-workflow-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/redhat-cop/vault-config-operator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/bmad-workflow-builder .claude/skills/bmad-workflow-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bmad-workflow-builder
GitHub stars
167
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
588 words
Files
30 (incl. scripts, references, assets)
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

Builds, converts, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator.

  • Works in 3 steps: Detect user's intent. If --headless or… → Load available config from… → Route by intent — see Quick Reference…
  • The user requests to build a workflow
  • SKILL.md covers Overview, On Activation, Build Process and Quality Analysis, plus 2 more sections
  • Modify a workflow

What it does

Bmad Workflow Builder is an agent skill from redhat-cop/vault-config-operator. 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".

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 31 other files, including scripts, reference files and assets (for example `assets/SKILL-template.md`, `references/build-process.md` and `references/classification-reference.md`).

The repository describes itself as: An operator to support Haschicorp Vault configuration workflows from within Kubernetes. The licence is Apache-2.0.

When your agent uses it

  • The user requests to build a workflow
  • Modify a workflow
  • Quality check workflow
  • Convert a skill

Example prompts

  • “build a workflow”
  • “modify a workflow”
  • “quality check workflow”
  • “/bmad-workflow-builder”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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…
  3. Route by intent — see Quick Reference below.

What it can do on your machine

Read from SKILL.md and the folder at commit 99762c2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bmad Workflow Builder loads about 1.4k tokens when it runs, and up to ~44k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 588 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~44k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from redhat-cop/vault-config-operator at commit 99762c2, republished under its Apache-2.0 licence (© redhat-cop). 588 words, ~1,350 tokens.

Download SKILL.mdSave it as .claude/skills/bmad-workflow-builder/SKILL.md (or your agent's skills folder). This skill also uses 29 other files; get the full folder from GitHub.
name
bmad-workflow-builder
description
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".

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.

Show full SKILL.md (239 more words)Show less

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.

© redhat-cop, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 29 other files (scripts, references, assets) in .cursor/skills/bmad-workflow-builder of redhat-cop/vault-config-operator.

  • SKILL.md
  • assets/SKILL-template.md
  • references/build-process.md
  • references/classification-reference.md
  • references/complex-workflow-patterns.md
  • references/convert-process.md
  • references/quality-analysis.md
  • references/quality-dimensions.md
  • references/quality-scan-enhancement-opportunities.md
  • references/quality-scan-execution-efficiency.md
  • references/quality-scan-prompt-craft.md
  • references/quality-scan-script-opportunities.md
  • references/quality-scan-skill-cohesion.md
  • references/quality-scan-workflow-integrity.md
  • references/report-quality-scan-creator.md
  • references/script-opportunities-reference.md
  • references/script-standards.md
  • references/skill-best-practices.md
  • references/standard-fields.md
  • … and 11 more

Open the folder on GitHubat commit 99762c2

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in redhat-cop/vault-config-operator, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bmad Workflow Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bmad Workflow Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Workflow Builder this skillredhat-cop/vault-config-operator1671 repos~1.4kAutomated safety check: PassApache-2.0
Convertremotion-dev/remotion62k—~247Automated safety check: PassCustom licence
Bmad Builderaj-geddes/claude-code-bmad-skills487—~1.9kAutomated safety check: NotesCustom licence
Agent Code Analyzerruvnet/ruflo74k3 repos~1.5kAutomated safety check: PassMIT
Agent Pagerank Analyzerruvnet/ruflo74k3 repos~2.9kAutomated safety check: PassMIT
Agent Performance Analyzerruvnet/ruflo74k2 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Convert

    remotion-dev/remotion

    Official

    Start the local @remotion/convert app and open it in the Codex browser.

    62k GitHub stars~247 tokensUpdated today
    Media & CreativeAuto-check passed
  • Bmad Builder

    aj-geddes/claude-code-bmad-skills

    Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin.

    487 GitHub stars~1.9k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Agent skill for code-analyzer - invoke with $agent-code-analyzer

    74k GitHub starsUsed in 3 repos~1.5k tokens
    DevelopmentAuto-check passed
  • Agent skill for pagerank-analyzer - invoke with $agent-pagerank-analyzer

    74k GitHub starsUsed in 3 repos~2.9k tokens
    Auto-check passed
  • Agent skill for performance-analyzer - invoke with $agent-performance-analyzer

    74k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Diff Analyze

    ruvnet/ruflo

    Analyze git diffs for risk scoring, reviewer recommendations, and change classification.

    74k GitHub stars~450 tokensUpdated today
    DevelopmentAuto-check: notes

More from redhat-cop/vault-config-operator

All 19 skills in this repo
  • Bmad Bmb Setup

    redhat-cop/vault-config-operator

    Sets up BMad Builder module in a project. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Bmad Eval Runner

    redhat-cop/vault-config-operator

    Run a skill's evals and report results. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Bmad Agent Builder

    redhat-cop/vault-config-operator

    Builds, edits or analyzes Agent Skills through conversational discovery.

    167 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Bmad Init

    redhat-cop/vault-config-operator

    Initialize BMad project configuration and load config variables.

    167 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Bmad Module Builder

    redhat-cop/vault-config-operator

    Plans, creates, and validates BMad modules. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~643 tokensUpdated yesterday
    Auto-check passed
  • Bmad Workflow Builder

    redhat-cop/vault-config-operator

    Builds, edits, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Bmad Workflow Builder

What does Bmad Workflow Builder do?

Builds, converts, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator. Bmad Workflow Builder is an agent skill from redhat-cop/vault-config-operator. Builds, converts, and analyzes workflows and skills.

When should I use Bmad Workflow Builder?

Bmad Workflow Builder fits situations like: the user requests to build a workflow; modify a workflow; quality check workflow; convert a skill.

How do I install Bmad Workflow Builder in Claude Code?

Run `npx skills add redhat-cop/vault-config-operator --skill bmad-workflow-builder -a claude-code`. Or copy the skill folder (.cursor/skills/bmad-workflow-builder in redhat-cop/vault-config-operator) into .claude/skills/bmad-workflow-builder in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Workflow Builder in Codex?

Run `npx skills add redhat-cop/vault-config-operator --skill bmad-workflow-builder -a codex`. Or copy the skill folder (.cursor/skills/bmad-workflow-builder in redhat-cop/vault-config-operator) into .agents/skills/bmad-workflow-builder in your project. Codex loads it when a task matches its description.

Can I use Bmad Workflow Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add redhat-cop/vault-config-operator --skill bmad-workflow-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-workflow-builder, .gemini/skills/bmad-workflow-builder, .github/skills/bmad-workflow-builder and .opencode/skills/bmad-workflow-builder in your project.

What does Bmad Workflow Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Bmad Workflow Builder is instructions for the agent only.

Does Bmad Workflow Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bmad Workflow Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bmad Workflow Builder use?

Bmad Workflow Builder is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bmad Workflow Builder use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 42k tokens, read only when the agent opens those files.

What are the alternatives to Bmad Workflow Builder?

Skills that share tags, products or a category with Bmad Workflow Builder: Convert (remotion-dev/remotion, 62k stars), Bmad Builder (aj-geddes/claude-code-bmad-skills, 487 stars), Agent Code Analyzer (ruvnet/ruflo, 74k stars) and Agent Pagerank Analyzer (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Workflow Builder?

redhat-cop (a GitHub organization) maintains it in redhat-cop/vault-config-operator, which has 167 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

Source: redhat-cop/vault-config-operator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.