⚙️

Agent Workflow Designer

Design agentic workflows for automation — map task sequences, define tool use patterns, set human-in-the-loop checkpoints, and optimize for reliability.

What this skill does

Design robust automation systems where multiple agents handle complex tasks that a single prompt cannot solve. Get a clear execution plan with built-in safety checks and budget controls to ensure reliable results without constant manual oversight. Use this when your projects need structured steps between specialized tasks instead of relying on a single instruction.

@alirezarezvani · Development
view on github ↗

name: “agent-workflow-designer” description: “Agent Workflow Designer”

Agent Workflow Designer

Tier: POWERFUL
Category: Engineering
Domain: Multi-Agent Systems / AI Orchestration


Overview

Design production-grade multi-agent workflows with clear pattern choice, handoff contracts, failure handling, and cost/context controls.

Core Capabilities

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

When to Use

  • 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

Quick Start

# Generate a sequential workflow skeleton
python3 scripts/workflow_scaffolder.py sequential --name content-pipeline

# Generate an orchestrator workflow and save it
python3 scripts/workflow_scaffolder.py orchestrator --name incident-triage --output workflows/incident-triage.json

Pattern Map

  • sequential: strict step-by-step dependency chain
  • parallel: fan-out/fan-in for independent subtasks
  • router: dispatch by intent/type with fallback
  • orchestrator: planner coordinates specialists with dependencies
  • evaluator: generator + quality gate loop

Detailed templates: references/workflow-patterns.md


  1. Select pattern based on dependency shape and risk profile.
  2. Scaffold config via scripts/workflow_scaffolder.py.
  3. Define handoff contract fields for every edge.
  4. Add retry/timeouts and output validation gates.
  5. Dry-run with small context budgets before scaling.

Common Pitfalls

  • Over-orchestrating tasks solvable by one well-structured prompt
  • Missing timeout/retry policies for external-model calls
  • Passing full upstream context instead of targeted artifacts
  • Ignoring per-step cost accumulation

Best Practices

  1. Start with the smallest pattern that can satisfy requirements.
  2. Keep handoff payloads explicit and bounded.
  3. Validate intermediate outputs before fan-in synthesis.
  4. Enforce budget and timeout limits in every step.

Install this Skill

Skills give your AI agent a consistent, structured approach to this task — better output than a one-off prompt.

npx skills add alirezarezvani/claude-skills --skill engineering/agent-workflow-designer
Download ZIP

Community skill by @alirezarezvani. Need a walkthrough? See the install guide →

Works with

Prefer no terminal? Download the ZIP and place it manually.

Details

Category
Development
License
MIT
Source file
show path engineering/agent-workflow-designer/SKILL.md
agent-workflows automation AI orchestration human-in-the-loop