Team Tasks
win4r/team-tasks
Coordinate multi-agent development pipelines using shared JSON task files.
A skill your agent uses when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution…
Install Agent Designer
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alirezarezvani/claude-skills agent-designer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/skills/agent-designer .claude/skills/agent-designer && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .claude/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alirezarezvani/claude-skills agent-designer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering/skills/agent-designer .agents/skills/agent-designer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .agents/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alirezarezvani/claude-skills agent-designer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering/skills/agent-designer .cursor/skills/agent-designer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .cursor/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alirezarezvani/claude-skills.git --path engineering/skills/agent-designer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alirezarezvani/claude-skills agent-designer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering/skills/agent-designer .gemini/skills/agent-designer && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .gemini/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alirezarezvani/claude-skills agent-designerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering/skills/agent-designer .github/skills/agent-designer && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .github/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-skills --skill agent-designer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alirezarezvani/claude-skills agent-designer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering/skills/agent-designer .opencode/skills/agent-designer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agent-designer" agent skill from https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/agent-designer into .opencode/skills/agent-designer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-designer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
agent-designer- GitHub stars
- 28k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 377 words
- Files
- 14 (incl. references, assets)
- Skills in repo
- 342
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution…
- Works in 4 steps: Design the architecture → Generate tool schemas → Evaluate execution logs → …
- The user asks to design a multi-agent system
- SKILL.md covers When to use, Pattern decision table, Workflow and References
- Runs Python scripts from its folder; calls python3
What it does
Agent Designer is an agent skill from alirezarezvani/claude-skills. Use when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution logs for cost, latency, and failure bottlenecks. Examples: 'design an agent architecture for research automation', 'generate Anthropic tool schemas from these tool descriptions', 'analyze these agent run logs for bottlenecks'. NOT for Claude Code workflow files (use workflow-builder) or single-agent prompt design (use…
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files and assets (for example `README.md`, `agent_evaluator.py` and `agent_planner.py`).
It sits in Agent Workflows, covering Multi-agent orchestration, Prompt engineering and Agent evaluation and testing. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.
When your agent uses it
- The user asks to design a multi-agent system
- Pick an orchestration pattern (supervisor/swarm/pipeline)
- Generate tool schemas for agents
- Evaluate agent execution logs for cost
Example prompts
- “design an agent architecture for research automation”
- “generate Anthropic tool schemas from these tool descriptions”
- “analyze these agent run logs for bottlenecks”
- “/agent-designer”
Requirements
- Python 3
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Agent Designer loads about 1.1k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 134 tokens; SKILL.md has 377 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 377 words, ~1,055 tokens.
Download SKILL.mdSave it as
.claude/skills/agent-designer/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.- name
- agent-designer
- description
- Use when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution logs for cost, latency, and failure bottlenecks. Examples: 'design an agent architecture for research automation', 'generate Anthropic tool schemas from these tool descriptions', 'analyze these agent run logs for bottlenecks'. NOT for Claude Code workflow files (use workflow-builder) or single-agent prompt design (use agent-workflow-designer).
Agent Designer — Multi-Agent System Architecture
Design, schema-generate, and evaluate multi-agent systems with three deterministic tools. The scripts are the workflow — do not freehand an architecture when the planner can score one from requirements.
When to use
- Designing a new multi-agent system from requirements (pattern choice, roles, comms)
- Generating provider-ready tool schemas (Anthropic + OpenAI formats) from plain tool descriptions
- Evaluating execution logs: success rate, latency distribution, cost, bottlenecks
When NOT to use: Claude Code Workflow-tool automations → workflow-builder; single-agent workflow scaffolds → agent-workflow-designer; multi-agent fan-out at runtime → agenthub.
Pattern decision table
| Choose | When | Watch out for |
|---|---|---|
| Single agent | One bounded task, < ~5 tools | Don't add agents you don't need |
| Supervisor | Central decomposition, specialists report back | Supervisor becomes the bottleneck |
| Pipeline | Strictly sequential stages with handoffs | Rigid order; slowest stage gates throughput |
| Hierarchical | Multiple org layers, > ~8 agents | Communication overhead per level |
| Swarm | Parallel peers, fault tolerance over predictability | Hard to debug; needs consensus rules |
The planner applies this scoring deterministically — run it rather than picking by feel.
Workflow
All paths relative to this skill folder. Each step's JSON output is the next step's design input.
1. Design the architecture
Write a requirements JSON (copy assets/sample_system_requirements.json — keys: goal, tasks[], constraints{max_response_time, budget_per_task, concurrent_tasks}, team_size):
python3 agent_planner.py requirements.json --format json -o archEmits arch.json with architecture_design (pattern, agents, communication links), mermaid_diagram, and implementation_roadmap. Read architecture_design.pattern and the per-agent role list; present the mermaid diagram to the user.
Show full SKILL.md (153 more words)Show less
2. Generate tool schemas
Describe each agent's tools in plain JSON (copy assets/sample_tool_descriptions.json), then:
python3 tool_schema_generator.py tool_descriptions.json --validate -o toolsEmits tools.json (tool_schemas, validation_summary) plus provider-specific tools_anthropic.json / tools_openai.json. Gate: every tool must print ✓ Valid. Fix any invalid schema before proceeding — never hand an agent an unvalidated schema.
3. Evaluate execution logs
Once the system runs (or against assets/sample_execution_logs.json for a dry run):
python3 agent_evaluator.py execution_logs.json --detailed -o evalEmits eval.json with summary, agent_metrics, bottleneck_analysis, error_analysis, cost_breakdown, sla_compliance, and optimization_recommendations, plus split files (eval_errors.json, eval_recommendations.json).
4. Verification loop
The design is not done until:
tool_schema_generator.py --validatereports 0 invalid schemas.agent_evaluator.pyon a pilot run reports 0 critical issues (the tool printsCRITICAL: N critical issueswhen found). If N > 0, apply the top item ineval_recommendations.json, re-run the pilot, and re-evaluate.- Compare your outputs against
expected_outputs/to confirm the schema shape you're consuming hasn't drifted.
References
references/agent_architecture_patterns.md— pattern trade-offs in depthreferences/tool_design_best_practices.md— schema, idempotency, error-handling rulesreferences/evaluation_methodology.md— metric definitions the evaluator implements
© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 13 other files (references, assets) in engineering/skills/agent-designer of alirezarezvani/claude-skills.
- SKILL.md
- README.md
- agent_evaluator.py
- agent_planner.py
- assets/sample_execution_logs.json
- assets/sample_system_requirements.json
- assets/sample_tool_descriptions.json
- expected_outputs/sample_agent_architecture.json
- expected_outputs/sample_evaluation_report.json
- expected_outputs/sample_tool_schemas.json
- references/agent_architecture_patterns.md
- references/evaluation_methodology.md
- references/tool_design_best_practices.md
- tool_schema_generator.py
Open the folder on GitHubat commit 19392f7
Compare with similar skills
Agent Designer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agent Designer this skillalirezarezvani/claude-skills | 28k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Team Taskswin4r/team-tasks | 446 | — | ~2.9k | Automated safety check: Pass | None | |
| Agent Orchestration Improve Agentaiskillstore/marketplace | 430 | 8 repos | ~2.6k | Automated safety check: Pass | None | |
| Benchmark Agentsvercel/vercel-plugin | 301 | — | ~3.6k | Automated safety check: Pass | Custom licence | |
| Flow SwarmLeoYeAI/openclaw-master-skills | 2.2k | — | ~5.3k | Automated safety check: Pass | MIT | |
| Agent OrchestrationLeoYeAI/openclaw-master-skills | 2.2k | — | ~4.4k | Automated safety check: Pass | MIT |
Similar skills
Agent Orchestration Improve Agent
aiskillstore/marketplace
Systematic improvement of existing agents through performance analysis, prompt engineering, and continuous iteration.
- Official
Benchmark Agents
vercel/vercel-plugin
Advanced AI agent benchmark scenarios that push Vercel's cutting-edge platform features — Workflow SDK, AI Gateway, MCP, Chat SDK, Queues, Flags, Sandbox, and multi-agent orchestration.
Flow Swarm
LeoYeAI/openclaw-master-skills
Multi-agent swarm orchestration via RuFlo + Claude Code. An agent skill from LeoYeAI/openclaw-master-skills.
Agent Orchestration
LeoYeAI/openclaw-master-skills
Multi-agent orchestration patterns for production deployments.
A-Evolve Agent Improvement
aiming-lab/AutoResearchClaw
Diagnoses where an agent failed across runs and turns the findings into new skills, system prompt patches and knowledge entries, using the A-Evolve loop.
More from alirezarezvani/claude-skills
All 342 skills in this repoAgile Product Owner
alirezarezvani/claude-skills
Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.
Product Strategist
alirezarezvani/claude-skills
OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.
App Store Optimization
alirezarezvani/claude-skills
App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.
AWS Solution Architect
alirezarezvani/claude-skills
Design AWS architectures for startups using serverless patterns and IaC templates.
Campaign Analytics
alirezarezvani/claude-skills
Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.
Code to PRD
alirezarezvani/claude-skills
Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.
Related
Categories
Questions about Agent Designer
What does Agent Designer do?
A skill your agent uses when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution…. Agent Designer is an agent skill from alirezarezvani/claude-skills. Use when the user asks to design a multi-agent system, pick an orchestration pattern (supervisor/swarm/pipeline), generate tool schemas for agents, or evaluate agent execution logs for cost, latency, and failure bottlenecks.
When should I use Agent Designer?
Agent Designer fits situations like: the user asks to design a multi-agent system; pick an orchestration pattern (supervisor/swarm/pipeline); generate tool schemas for agents; evaluate agent execution logs for cost.
How do I install Agent Designer in Claude Code?
Run `npx skills add alirezarezvani/claude-skills --skill agent-designer -a claude-code`. Or copy the skill folder (engineering/skills/agent-designer in alirezarezvani/claude-skills) into .claude/skills/agent-designer in your project. Claude Code loads it when a task matches its description.
How do I install Agent Designer in Codex?
Run `npx skills add alirezarezvani/claude-skills --skill agent-designer -a codex`. Or copy the skill folder (engineering/skills/agent-designer in alirezarezvani/claude-skills) into .agents/skills/agent-designer in your project. Codex loads it when a task matches its description.
Can I use Agent Designer in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill agent-designer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-designer, .gemini/skills/agent-designer, .github/skills/agent-designer and .opencode/skills/agent-designer in your project.
What does Agent Designer need to run?
Going by SKILL.md and its folder, Agent Designer needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Agent Designer access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Agent Designer safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Agent Designer use?
Agent Designer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Agent Designer use?
About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.
What are the alternatives to Agent Designer?
Skills that share tags, products or a category with Agent Designer: Team Tasks (win4r/team-tasks, 446 stars), Agent Orchestration Improve Agent (aiskillstore/marketplace, 430 stars), Benchmark Agents (vercel/vercel-plugin, 301 stars) and Flow Swarm (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Agent Designer?
alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.
Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.