Workflow
Multi-phase agent orchestration system. Bootstraps .claude/workflows/ in any project. Commands: init (bootstrap), run (execute), list (show workflows), create (new from template), plan (build plan). Use when: "init workflows", "run workflow X", "list workflows", "create workflow".From its SKILL.md
npx -y skills add xirothedev/claude-workflow-plugin --skill workflowAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.5 KB, as published. Nobody here has run it
Workflow Engine
Portable multi-phase agent orchestration. Bootstraps .claude/workflows/ in any project.
Commands
Two kinds. Skill actions (init, run, create) are orchestrated by Claude.
CLI subcommands are run via bun run .claude/workflows/cli.ts <subcommand>:
| CLI subcommand | Purpose |
|---|---|
list | List discoverable workflows |
plan <name> '<args>' | Build plan as JSON |
show <name> '<args>' | Build plan in readable form |
validate <name> '<args>' | Validate args against args_schema |
meta <name> | Print workflow metadata |
init — Bootstrap workflow system in current project
Run: bun run <skill-dir>/skills/workflow/scripts/init.ts
This generates in the current project:
.claude/workflows/
├── cli.ts # bun run .claude/workflows/cli.ts <command>
├── src/ # Runtime (symlinked to plugin)
│ ├── types.ts
│ ├── runtime.ts
│ └── validator.ts
├── templates/ # Starter workflows (copied, user can customize)
└── README.md
Non-destructive: existing files are NEVER overwritten.
run <workflow> [args] — Execute a workflow
- Build plan:
bun run .claude/workflows/cli.ts show <name> '<args-json>' - Parse plan output
- Execute stage by stage (agents in same stage run in parallel)
- Validate each agent output against schema; on failure, retry the agent once with the validation errors fed back
- Report results
Adversarial verify — for verified-swarm/survey-round, a Verify phase runs
several independent voters per item. Run that item's Fix agent only if the
majority rejected it; skip the rest. This catches agents that suppress errors
instead of fixing them.
Convergence loop — survey-round is the plan for one round only. The
static-plan runtime cannot express a round-loop, so drive it yourself: run the
round, read the Survey agent's remaining, and repeat until remaining == 0 or a
MAX_ROUNDS cap. The orchestrate skill describes the full loop.
Agent invocation:
Agent({
description: "<label>",
prompt: "<prompt>\n\nIMPORTANT: Return ONLY valid JSON matching this schema:\n<schema>\n\nNo markdown fences, no commentary, only the JSON object.",
})
list — List workflows
bun run .claude/workflows/cli.ts list
plan <workflow> [args] — Build plan without executing
- Readable:
bun run .claude/workflows/cli.ts show <name> '<args-json>' - JSON:
bun run .claude/workflows/cli.ts plan <name> '<args-json>'
create <name> [template] — Create new workflow from template
- Pick template:
single-agent— one agent, schema-validated outputmulti-stage— implement → verify → fix pipelineparallel-swarm— N agents in parallel + aggregateverified-swarm— parallel implement + 3-vote adversarial verify + conditional fixsurvey-round— one round of a convergence loop (survey → fix → verify)
- Copy
<skill-dir>/skills/workflow/templates/<template>.workflow.tsto.claude/workflows/<name>.workflow.ts - Rewrite the import:
../src/types.ts→./src/types.ts(templates live one dir deeper than root workflows) - Prompt user for customization
- Write with TODO markers
How to discover <skill-dir>
The skill directory is wherever this plugin is installed. Check:
~/.claude/plugins/claude-workflow-plugin/skills/workflow/- Or the directory containing this SKILL.md file
Use ${CLAUDE_SKILL_DIR} environment variable if available, or ask the user.
Workflow File Contract
import type { WorkflowMeta, WorkflowContext } from "./src/types.ts";
export const meta: WorkflowMeta = { name, description, phases, args_schema? };
export function execute(ctx: WorkflowContext): Record<string, unknown> { ... }
Runtime API in ctx:
ctx.agent(prompt, { label, phase, schema })— register agentctx.pipeline(items, stage)— parallel stagectx.multiPipeline(items, ...stages)— multi-stagectx.phase(title)— mark phasectx.log(msg)— structured logctx.validate(value, schema)— JSON Schema validation