CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-designer

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

78

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written, highly actionable skill body with a validation-gated workflow and feedback loop. The one real defect is bundle integrity: the scripts and expected_outputs/ paths the workflow depends on are missing from the skill folder.

Suggestions

Ship the three referenced scripts (agent_planner.py, tool_schema_generator.py, agent_evaluator.py) — e.g., in a scripts/ subfolder with the commands updated to scripts/<name>.py — so the workflow's 'paths relative to this skill folder' claim holds.

Add the expected_outputs/ directory referenced in verification step 3, or drop that step if the comparison material cannot be bundled.

Add a one-line file-map of the bundle (scripts/, references/, assets/) near the top so the layout is discoverable at a glance.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: a compact pattern decision table, one-line step descriptions, and bash commands with flags — no padding and no explanation of concepts Claude already knows (e.g., it never explains what a supervisor pattern is, it just says "run it rather than picking by feel"). Every token earns its place, matching the top anchor.

5 / 5

Actionability

Guidance is fully executable: copy-paste commands with flags and output paths ("python3 agent_planner.py requirements.json --format json -o arch"), named sample assets to copy ("copy assets/sample_system_requirements.json"), specified output keys (architecture_design.pattern, tool_schemas, validation_summary), and explicit gates ("every tool must print ✓ Valid"). This matches the copy-paste-ready top anchor.

5 / 5

Workflow Clarity

A clearly sequenced 4-step workflow with explicit validation checkpoints and a feedback loop: the verification loop requires "0 invalid schemas" and "0 critical issues", and prescribes recovery ("If N > 0, apply the top item in eval_recommendations.json, re-run the pilot, and re-evaluate"). This matches the top anchor with validation steps, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

Structure is good — a concise overview with clearly signaled one-level-deep references ("references/agent_architecture_patterns.md — pattern trade-offs in depth", etc.) that all exist in the bundle. However, the body states "All paths relative to this skill folder" yet the three core scripts it invokes (agent_planner.py, tool_schema_generator.py, agent_evaluator.py) and the "expected_outputs/" directory referenced in the verification loop do not exist in the bundle, so several referenced paths are unresolvable — a navigation gap that fits anchor 4 (minor organization gaps) rather than the fully navigable anchor 5.

4 / 5

Total

19

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete capabilities, explicit third-person trigger guidance with verbatim example prompts, and explicit NOT-for boundaries that route users to neighboring skills. No vague language or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering all three functions: "design a multi-agent system", "pick an orchestration pattern (supervisor/swarm/pipeline)", "generate tool schemas for agents", and "evaluate agent execution logs for cost, latency, and failure bottlenecks". Coverage is comprehensive with no vague filler, matching the top anchor; a 4 would require minor gaps in coverage, which are absent.

5 / 5

Completeness

Both "what" (design, pattern selection, schema generation, log evaluation with cost/latency/failure dimensions) and "when" ("Use when the user asks to..." with three concrete example prompts) are explicitly and clearly answered. This matches the anchor requiring concrete trigger phrases for both; a 4 would need a weaker or less explicit "when" clause.

5 / 5

Trigger Term Quality

Natural trigger phrases are supplied verbatim ("design an agent architecture for research automation", "generate Anthropic tool schemas from these tool descriptions", "analyze these agent run logs for bottlenecks") alongside domain keywords users would naturally say (multi-agent system, orchestration pattern, tool schemas, bottlenecks). Coverage is comprehensive; a 4 would mean a few natural terms are missing, but the quoted examples cover the full range of user phrasings.

5 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche and actively disambiguates: "NOT for Claude Code workflow files (use workflow-builder) or single-agent prompt design (use agent-workflow-designer)". Explicit negative boundary guidance plus distinct multi-agent triggers make conflict risk minimal, matching the top anchor rather than the "minor overlap risk" of a 4.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

engineering/skills/agent-designer/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.