# agent-designer

agent-designer — a skill for Claude Code and related platforms that plans multi-agent architectures. It generates tool definitions for Anthropic and OpenAI, diagrams communication flows, and parses runtime logs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 161 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-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-designer

## What it does

The toolkit includes three Python scripts: `agent_planner.py`, `tool_schema_generator.py`, and `agent_evaluator.py`. The planner evaluates requirements to choose topologies like supervisor, pipeline, swarm, or hierarchical setups, providing a Mermaid diagram alongside agent assignments.

The schema utility transforms tool specs into interfaces for OpenAI function calling and Anthropic formats, enforcing parameter types and validation rules. To inspect operational behavior, `agent_evaluator.py` parses execution history. It highlights task success, latency distributions, and total expenses based on the logged `cost_usd` property without depending on external pricing tables.

Writing outputs to files requires the `-o PREFIX` option, as scripts print summaries straight to stdout by default. Any unreadable or malformed JSON input terminates processing with exit code 2.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-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-designer/SKILL.md
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill agent-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-designer/SKILL.md

## When to use it
- select an orchestration topology for autonomous agent workflows
- produce validated tool schemas for OpenAI and Anthropic models
- render agent interaction flows into Mermaid diagrams
- diagnose bottlenecks and execution failures from agent log files

## Example prompts
- Design a multi-agent supervisor architecture based on the specifications in `requirements.json`.
- Generate validated Anthropic and OpenAI tool schemas from `tool_specs.json`.
- Evaluate agent execution performance and bottleneck areas using `execution_logs.json`.

## Similar
- [agent-workflow-designer](https://affpapa.org/en/nevibecode/skills/agent-workflow-designer.md) — skill · 658 installs
- [ai-agent-orchestrator](https://affpapa.org/en/nevibecode/skills/ai-agent-orchestrator.md) — skill · 367 installs
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9377 repo stars
- [multi-agent-orchestration](https://affpapa.org/en/nevibecode/skills/multi-agent-orchestration.md) — skill · 2200 installs
- [crewai](https://affpapa.org/en/nevibecode/skills/crewai.md) — skill · 141 installs
- [anthropic-claude-development](https://affpapa.org/en/nevibecode/skills/anthropic-claude-development.md) — skill · 770 installs

## Other versions with the same name
- [agent-designer · alirezarezvani](https://affpapa.org/en/nevibecode/skills/agent-designer.md) — 682 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
