Skip to main content
skill CX Codex

agent-designer · borghei — Claude Code skill: what it does, how to install

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.

LicenseRef-MIT-Commons-Clause 161 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill agent-designer -a claude-code
Open on GitHub

What agent-designer 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.

What it helps with

  • 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 for the agent

  • 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.

How to install agent-designer

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill agent-designer -a claude-code

2Manually: put the files in place

~/.claude/skills/agent-designer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-designer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-designer

How to install agent-designer in Claude Code?

Run npx skills add borghei/Claude-Skills --skill agent-designer -a claude-code.

What does agent-designer do?

It guides the design of multi-agent systems, formats function schemas for major model providers, and assesses execution logs for latency and cost bottlenecks.

How does agent_evaluator.py calculate model expenses?

The script does not store pricing rates. It reads financial numbers directly from the cost_usd entry inside the input log records.

Similar skills

All skills for Agent setup: memory, context, orchestration →

agent-designer by other authors comes first.

agent-designer Alireza Rezvani agent-designer turns written requirements into a multi-agent architecture, validated tool schemas and a read on your run logs. Worth running before you wire agents to a design you picked by gut. CX Codex +1 682installs agent-workflow-designer Alireza Rezvani agent-workflow-designer picks a multi-agent workflow pattern and scaffolds the config before you write code, with handoff contracts and retry gates spelled out. CX Codex +1 658installs ai-agent-orchestrator patricio0312rev ai-agent-orchestrator — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that builds multi-agent systems with task delegation, agent handoffs, and shared memory. CX Codex +1 367installs PraisonAI MervinPraison PraisonAI is an MCP server for Claude Code that runs autonomous agents to execute tasks through tools and external APIs. CX Codex +1 ★ 9,377repo stars multi-agent-orchestration qodex-ai multi-agent-orchestration guides the architecture of multi-agent setups, delegating specialized roles and combining outputs. Helpful for multi-stage workflows across multiple LLMs. CX Codex +1 2,200installs crewai davila7 Designs multi-agent teams on CrewAI: roles, tasks, orchestration and process types. Useful once a single agent stops being enough. CX Codex +1 141installs anthropic-claude-development Mindrally anthropic-claude-development — a skill for Claude Code and five other agent environments. It carries Anthropic API practices: Messages API, tool use, prompt engineering, and retry logic for Python code. CX Codex +1 770installs

From the same set120

The whole set →
cto-advisor cto-advisor — a skill for technology strategy, team scaling and architecture decisions. Helps plan engineering growth, prioritise technical debt and evaluate vendors. CX Codex +1 177installs database-designer The database-designer skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode reviews SQL schemas, suggests indexes, and creates migrations. Use it for DDL reviews, index tuning, or schema diffs. CX Codex +1 176installs api-design-reviewer api-design-reviewer — a skill for Claude Code inspects OpenAPI specs, catches breaking schema changes between versions, and grades REST API architecture maturity. CX Codex +1 167installs information-security-manager-iso27001 information-security-manager-iso27001 is a Claude Code skill for designing and auditing an ISO 27001:2022 ISMS, covering risk assessment, Annex A controls, and certification readiness. CX Codex +1 166installs marketing-psychology The marketing-psychology skill uses behavioral psychology and mental models to diagnose marketing friction. Use it for landing pages, pricing, email, ads, and conversion work. CX Codex +1 151installs aws-solution-architect aws-solution-architect — a skill for Claude Code, Codex, and Cursor that designs AWS architectures and outputs IaC templates. Tailors cloud patterns to workload demands and flags infrastructure savings. CX Codex +1 150installs playwright-pro playwright-pro — a skill for Claude Code, Codex, and Cursor. Generates Playwright end-to-end tests, builds Page Object structures, diagnoses flaky runs, and migrates suites from Cypress or Selenium. CX Codex +1 148installs skill-security-auditor skill-security-auditor — a skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode that scans agent skills before install. It detects prompt injection, dangerous code, credential harvesting and supply chain risks. CX Codex +1 146installs

Project sponsors

Companies that keep this analytics open