# agent-workflow-designer

The agent-workflow-designer Claude Code skill designs workflows for multiple AI agents and estimates their cost before implementation. It comes into play when planning parallel tasks, delegation, or request routing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 123 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/agent-workflow-designer/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-agent-workflow-designer

## What it does

The skill helps select a structure for multi-agent work: sequential, parallel, hierarchical, event-driven, or consensus-based. It also covers routing, workflow state, and failure handling.

Included scripts validate a workflow DAG, render a Mermaid diagram, and estimate costs for either a step-based design or a lead agent with subagents. They inspect workflow files; they do not start agents. Provider price lists are not bundled. Supply your own pricing file for rate-based estimates, or the estimator uses a placeholder rate inferred from the model tier.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-workflow-designer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-workflow-designer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-workflow-designer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-workflow-designer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-workflow-designer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-workflow-designer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-workflow-designer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/agent-workflow-designer/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-workflow-designer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-workflow-designer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/agent-workflow-designer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-workflow-designer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-workflow-designer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/agent-workflow-designer/SKILL.md

## When to use it
- choose a structure for a pipeline of specialist agents
- run independent tasks in parallel and combine their results
- find cycles and unreachable steps in a workflow DAG
- estimate workflow costs before implementation

## Example prompts
- Design a multi-agent workflow that researches several sources in parallel and combines the findings.
- Check `assets/sample_workflow.json` for cycles and unreachable steps.
- Compare the cost of a lead agent with subagents against one stronger agent.

## Similar
- [agent-graphs](https://affpapa.org/en/nevibecode/skills/agent-graphs.md) — skill · 1800 installs
- [agent-designer](https://affpapa.org/en/nevibecode/skills/agent-designer.md) — skill · 682 installs
- [langgraph](https://affpapa.org/en/nevibecode/skills/orchestkit-langgraph.md) — skill · 377 installs
- [arena](https://affpapa.org/en/nevibecode/skills/arena.md) — skill · 10800 installs
- [context-engineering-collection](https://affpapa.org/en/nevibecode/skills/context-engineering-collection.md) — skill · 4500 installs
- [multi-agent-orchestration](https://affpapa.org/en/nevibecode/skills/multi-agent-orchestration.md) — skill · 2200 installs

## Other versions with the same name
- [agent-workflow-designer · alirezarezvani](https://affpapa.org/en/nevibecode/skills/agent-workflow-designer.md) — 658 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
