Agent skill · product strategy · alirezarezvani
agent-designer
Design multi-agent systems (supervisor, swarm, pipeline) and tool schemas; find bottlenecks in run logs. Use whenever agents split work or a run is slow or costly. Not for Claude Code workflow files (workflow-builder).
Why this skill is useful
Adds executable scripts for designing, generating schemas, and evaluating multi-agent systems that extend the AI's capabilities.
What it needs
Requires python3 installed locally. About 2k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
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/samplesystemrequirements.json — keys: goal, tasks[], constraints{maxresponsetime, budgetpertask, concurrenttasks}, teamsize): Emits arch.json with architecturedesign (pattern, agents, communication links), mermaiddiagram, and implementationroadmap. Read architecturedesign.pattern and the per-agent role list; present the mermaid diagram to the user. 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/agent-designer--d5d6f4