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.
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 chainparallel: fan-out/fan-in for independent subtasksrouter: dispatch by intent/type with fallbackorchestrator: planner coordinates specialists with dependenciesevaluator: generator + quality gate loop
Detailed templates: references/workflow-patterns.md
Recommended Workflow
- Select pattern based on dependency shape and risk profile.
- Scaffold config via
scripts/workflow_scaffolder.py. - Define handoff contract fields for every edge.
- Add retry/timeouts and output validation gates.
- 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
- Start with the smallest pattern that can satisfy requirements.
- Keep handoff payloads explicit and bounded.
- Validate intermediate outputs before fan-in synthesis.
- 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 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
- Author
- @alirezarezvani
- Source
- GitHub →
- Source file
-
show path
engineering/agent-workflow-designer/SKILL.md
People who install this also use
Agent Designer
Design and orchestrate multi-agent AI systems — define agent roles, communication protocols, tool use patterns, and failure recovery strategies.
@alirezarezvani
RAG Architect
Design and build Retrieval-Augmented Generation systems — chunking strategies, embedding selection, vector store setup, and query pipeline optimization.
@alirezarezvani
MCP Server Builder
Create Model Context Protocol servers from scratch — define tools, resources, and prompts, then wire up to external APIs or local services.
@alirezarezvani