Agent Workflow Designer

Design production-grade multi-agent workflows with clear pattern choice (sequential, parallel, hierarchical), handoff contracts, failure handling, and cost/context controls. It scaffolds workflow configurations and provides guidance on pattern selection, error recovery, and context discipline.

✨ What it does

  • Workflow pattern selection for multi-step agent systems.
  • Skeleton config generation via workflow_scaffolder.py.
  • Context and cost discipline across long-running flows.
  • Error recovery and retry strategy scaffolding.
  • Documentation pointers for operational pattern tradeoffs.

🎯 When to use it

  • A single prompt is insufficient for task complexity.
  • You need specialist agents with explicit boundaries.
  • You want deterministic workflow structure before implementation.
  • You need validation loops for quality or safety gates.

🚀 How to use

Trigger by asking to design or scaffold a multi-agent workflow, e.g., 'Design a sequential workflow for content pipeline' or 'Generate an orchestrator workflow for incident triage'. The skill expects a pattern name (sequential, parallel, router, orchestrator, evaluator) and a workflow name; optionally specify an output path. Example prompts:

python3 scripts/workflow_scaffolder.py sequential --name content-pipeline
python3 scripts/workflow_scaffolder.py orchestrator --name incident-triage --output workflows/incident-triage.json

📄 Output: A scaffolded workflow configuration file (JSON) and/or guidance on pattern selection and best practices.

📦 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/skills/agent-workflow-designer .claude/skills/agent-workflow-designer

Skill source: engineering/skills/agent-workflow-designer/SKILL.md

⚠️ Good to know

Requires Python 3 to run the scaffolder script; the skill provides templates and guidance but does not implement the agents themselves.

❓ FAQ

What patterns are supported?

The skill supports sequential, parallel, router, orchestrator, and evaluator patterns, each suited for different dependency shapes and risk profiles.

How do I generate a workflow skeleton?

Use the workflow_scaffolder.py script with a pattern and name, e.g., python3 scripts/workflow_scaffolder.py sequential --name content-pipeline.

What are common pitfalls to avoid?

Common pitfalls include over-orchestrating simple tasks, missing timeouts/retries, passing full context instead of targeted artifacts, and ignoring cost accumulation.

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