Skip to content
cccskills
FreePublished on GitHub

bmad-workflow-builder

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".

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (28)

  • SKILL.md5.3 KB
  • assets/SKILL-template.md1.3 KB
  • references/build-process.md9.3 KB
  • references/classification-reference.md3.5 KB
  • references/complex-workflow-patterns.md4.3 KB
  • references/convert-process.md4.8 KB
  • references/quality-analysis.md7.4 KB
  • references/quality-dimensions.md3.1 KB
  • references/quality-scan-enhancement-opportunities.md15.6 KB
  • references/quality-scan-execution-efficiency.md15.1 KB
  • references/quality-scan-prompt-craft.md28.3 KB
  • references/quality-scan-script-opportunities.md10.8 KB
  • references/quality-scan-skill-cohesion.md9.9 KB
  • references/quality-scan-workflow-integrity.md17.8 KB
  • references/report-quality-scan-creator.md8.9 KB
  • references/script-opportunities-reference.md4.7 KB
  • references/script-standards.md4.4 KB
  • references/skill-best-practices.md8.0 KB
  • references/standard-fields.md6.9 KB
  • references/template-substitution-rules.md1.8 KB
  • scripts/generate-convert-report.py15.9 KB
  • scripts/generate-html-report.py23.9 KB
  • scripts/prepass-execution-deps.py9.3 KB
  • scripts/prepass-prompt-metrics.py10.4 KB
  • scripts/prepass-workflow-integrity.py16.3 KB
  • scripts/scan-path-standards.py10.6 KB
  • scripts/scan-scripts.py26.2 KB
  • scripts/tests/test_generate_convert_report.py9.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

代码仓库 AI 亲和度审计工具,支持前端、后端、全栈等各类项目。此技能用于检查给定的代码仓库对 AI Coding 工具的友好程度,生成详细的分析报告和改进建议。当用户需要评估代码仓库是否适合 AI 辅助开发、希望提升仓库的 AI 可操作性、或准备引入 AI Coding 工具前进行仓库评估时,应使用此技能。支持 TypeScript/JavaScript、Go、Java/Kotlin、Python、Rust 等主流技术栈。融合 OpenAI Harness Engineering 方法论,评估 Outer Loop(反馈闭环、评估门禁、机械化不变量)建设。

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

OPC-Starter 智能开发技能。AI 亲和的 React Boilerplate 项目开发规范,支持动态上下文感知、TDD 驱动开发、Agent Studio 扩展。适用于认证系统、组织架构、Agent 工具、数据同步等模块的迭代开发。

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

Push the LLM to reconsider, refine, and improve its recent output. Use when user asks for deeper critique or mentions a known deeper critique method, e.g. socratic, first principles, pre-mortem, red team.

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

Strategic business analyst and requirements expert. Use when the user asks to talk to Mary or requests the business analyst.

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

System architect and technical design leader. Use when the user asks to talk to Winston or requests the architect.

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

Builds, edits or analyzes Agent Skills through conversational discovery. Use when the user requests to "Create an Agent", "Analyze an Agent" or "Edit an Agent".

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

See all skills by alibaba

Report a problem with this skill