agent-workflow-designer

alirezarezvani/claude-skills · .gemini/skills/agent-workflow-designer/SKILL.md

Design production-grade multi-agent workflows with clear pattern choice (sequential, parallel, hierarchical), handoff contracts, failure handling, and cost/context controls. Use when architecting a multi-step agent pipeline, choosing between single-agent vs multi-agent approaches, or refactoring an LLM workflow that suffers from context bloat or unreliable handoffs.

Data & AINo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

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

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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/agent-workflow-designer · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/agent-workflow-designer" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/agent-workflow-designer" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/agent-workflow-designer

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so agent-workflow-designer is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

agent-workflow-designer

alirezarezvani/claude-skills · .gemini/skills/agent-workflow-designer/SKILL.md

Data & AINo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

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

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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/agent-workflow-designer · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/agent-workflow-designer" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/agent-workflow-designer" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/agent-workflow-designer

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so agent-workflow-designer is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

agent-workflow-designer

What this skill does

Agent Workflow Designer

Overview

Core Capabilities

When to Use

Quick Start

Pattern Map

Recommended Workflow

Common Pitfalls

Best Practices

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

agent-workflow-designer

What this skill does

Agent Workflow Designer

Overview

Core Capabilities

When to Use

Quick Start

Pattern Map

Recommended Workflow

Common Pitfalls

Best Practices

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits