Workflow Builder — Development

Workflow Builder helps you design and write deterministic multi-agent workflow scripts (.js files) for Claude Code's Workflow tool. It guides you through intake, topology selection, scaffolding, validation, and running, producing runnable orchestration files that fan out work to fresh-context sub-agents.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Runs an intake session to clarify task, units, stages, and data needs.
Recommends a workflow topology (fan-out, pipeline, loop, etc.) with rationale via a script.
Scaffolds starter .js files for any topology.
Validates workflow files against hard rules (pure meta, no non-determinism, no Node APIs, guarded loops).
Provides orchestration patterns and API reference for writing workflows.
Supports running with /workflows and live controls (pause, skip, auto-retry).

🎯 When to use it

When you want to build, create, author, or scaffold a custom Claude Code workflow.
When you need to orchestrate multiple sub-agents in a fixed topology (fan-out, pipeline, loop, judge-panel).
When automating a repeatable multi-step task that benefits from fresh-context agents and resumability.

🚀 How to use

Trigger: /workflows

Trigger by asking to build a workflow, e.g., 'Create a workflow to triage PRs' or 'Help me write a multi-agent pipeline'. The skill starts with an intake questionnaire; if you're vague, it runs a recommendation engine. After confirming the topology, it scaffolds a file, you edit it, validate, then run with CLAUDE_CODE_WORKFLOWS=1 and /workflows.

Example prompts:

Build a workflow that reviews each PR in a list and outputs a verdict.
I need a pipeline to summarize, then grade, a batch of documents.

📄 Output: A runnable .js workflow file in .claude/workflows/.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/workflow-builder/skills/workflow-builder .claude/skills/workflow-builder

Skill source: engineering/workflow-builder/skills/workflow-builder/SKILL.md

⚠️ Good to know

Requires Claude Code's Workflow tool (CLAUDE_CODE_WORKFLOWS=1) and is only worthwhile for parallel or multi-stage deterministic tasks; for one-off tasks, use Claude directly.

❓ FAQ

What are the hard rules for a workflow file?

The meta block must be a pure literal and the first statement; no non-determinism (Date.now, Math.random), no filesystem/Node APIs in the orchestrator, parallel() takes thunks, and open-ended loops must be guarded.

How do I run a workflow after writing it?

Enable the feature with export CLAUDE_CODE_WORKFLOWS=1, save the file under .claude/workflows/, then use /workflows to launch and watch it live.

What if I'm not sure what topology I need?

The skill runs a recommendation engine (scripts/workflow_intake.py) that suggests a topology, model picks, and budget based on your vague description, and presents it with reasoning.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.