From orchestration
Debugs orchestration workflow execution issues like syntax errors, agent failures, variable problems, parallel hangs, and checkpoints. Use when workflows fail or produce unexpected results.
How this skill is triggered — by the user, by Claude, or both
Slash command
/orchestration:debugging-workflowsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
I help diagnose and fix workflow execution issues using systematic debugging techniques.
I help diagnose and fix workflow execution issues using systematic debugging techniques.
I activate when you:
Problem: Workflow won't parse
Symptoms:
Solutions:
->, ||, ~> (not => or &&)[...]"instruction"Problem: Agent reference doesn't resolve
Symptoms:
Solutions:
temp-agents/agent-name.mdagents/registry.jsonProblem: Variables not passing correctly
Symptoms:
{variable} shows as literal textSolutions:
agent:"task":variable_name"Use {variable_name}"Problem: Parallel tasks failing or hanging
Symptoms:
Solutions:
[task1 || task2 || task3]Problem: Checkpoints not triggering
Symptoms:
Solutions:
@checkpoint-nameRun workflow with minimal changes to reproduce issue.
Simplify workflow to find problematic section:
# If this fails:
step1 -> step2 -> step3 -> step4
# Try:
step1 -> step2 # Works?
step3 -> step4 # Works?
Check execution logs for error details.
Apply targeted fix based on findings.
Run full workflow to ensure fix works.
| Error | Meaning | Fix |
|---|---|---|
| "Unexpected token" | Syntax error | Check syntax around error location |
| "Agent not found" | Missing agent | Verify agent exists and spelling |
| "Variable not found" | Variable undefined | Check variable was captured |
| "Condition failed" | Condition not met | Check condition logic |
| "Execution timeout" | Task took too long | Add timeout handling or simplify task |
✅ DO:
❌ DON'T:
# Check temp agents exist
ls temp-agents/
# Verify agent registry
cat agents/registry.json
# Check workflow syntax file
cat examples/workflow-name.flow
Workflow not working? Show me the error and I'll help debug!
npx claudepluginhub mbruhler/claude-orchestration --plugin orchestrationExecutes orchestration workflows using -> || ~> syntax with real-time ASCII visualization, interactive steering at checkpoints, error recovery, and resume from .orchestration/state.json.
Validates, runs, and debugs multi-agent YAML workflows. Use when orchestrating AI agents, configuring routing, or setting up human-in-the-loop gates.
Authors a reusable, deterministic agent orchestration workflow as a self-contained .mjs script for Claude Code's Workflow tool, with structured phases, fan-out, and verification.