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

77

Quality

97%

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

The canonical home for this skill is agent-designer in alirezarezvani/claude-skills

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 well-engineered, lean workflow document with copy-paste commands, deterministic decision guidance, hard validation gates, and an explicit error-recovery loop. The only material defect is that every referenced bundle path (three reference docs, sample assets, expected outputs, and the scripts the commands invoke) is missing from the skill bundle, breaking the otherwise exemplary progressive-disclosure structure.

Suggestions

Ship the referenced bundle files (references/agent_architecture_patterns.md, references/tool_design_best_practices.md, references/evaluation_methodology.md, assets/sample_*.json, expected_outputs/, and the three invoked scripts) so the body's links and commands resolve.

If some referenced files are intentionally external or optional, mark them as such in the References section so the distinction is visible at a glance.

State where the scripts live (e.g., scripts/agent_planner.py) or confirm they sit at the skill root, since commands currently invoke bare filenames while other assets use directory paths.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: the pattern decision table distills trade-offs into a few earned tokens, and lines like "The planner applies this scoring deterministically — run it rather than picking by feel" instruct instead of explain. No padding or explanation of known concepts, matching anchor 5 rather than 4 (there is nothing to trim).

5 / 5

Actionability

Fully executable, copy-paste-ready commands with flags and outputs ("python3 agent_planner.py requirements.json --format json -o arch", "python3 tool_schema_generator.py tool_descriptions.json --validate -o tools") and inputs bootstrapped from documented sample files whose keys are enumerated. This matches anchor 5's 'specific examples cover the common cases'; anchor 4 would require gaps in the commands themselves, and there are none.

5 / 5

Workflow Clarity

Four clearly sequenced steps with explicit validation checkpoints and a feedback loop: "Gate: every tool must print `✓ Valid`", the verification loop requiring 0 invalid schemas and 0 critical issues, and "apply the top item in eval_recommendations.json, re-run the pilot, and re-evaluate" for error recovery, plus a drift check against expected_outputs/. This matches anchor 5 exactly; anchor 4 would lack the explicit retry loop or one of the gates.

5 / 5

Progressive Disclosure

Structure and signaling are excellent — one-level-deep references each with a one-line description ("references/agent_architecture_patterns.md — pattern trade-offs in depth"), samples and expected_outputs/ clearly flagged. However, none of the referenced bundle files (references/*.md, assets/sample_*.json, expected_outputs/, or the three scripts) exist in the actual bundle, so navigation as written dead-ends; this is more than the 'minor organization gaps' of anchor 5 but far better organized than anchor 3's buried/unclear references.

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 multi-action capability statement, verbatim user trigger phrases, explicit use-when guidance, and negative-scope boundaries that disambiguate it from adjacent skills. No vague or padded language is present.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the skill's full scope: "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" — comprehensive, not just several actions. It is in trigger form, not penalized first/second person, so anchor 5 fits better than 4.

5 / 5

Completeness

Both questions are explicitly answered: the "what" enumerates the three functions, and "Use when the user asks to…" plus three concrete example triggers gives a fully explicit "when". This matches the anchor-5 example structure, not the anchor-4 case where the "when" is present but could be more specific.

5 / 5

Trigger Term Quality

Natural user phrases are quoted verbatim ("design an agent architecture for research automation", "analyze these agent run logs for bottlenecks") with synonym coverage across "multi-agent system"/"agent architecture", "agent execution logs"/"agent run logs", and named patterns (supervisor/swarm/pipeline). Anchor 5 matches; 4 would require noticeably missing common terms, and none are absent for this domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche (multi-agent system design/schema generation/log evaluation) is reinforced by explicit negative scope: "NOT for Claude Code workflow files (use workflow-builder) or single-agent prompt design (use agent-workflow-designer)". Conflict risk with neighboring skills is actively disambiguated, which exceeds the anchor-4 'minor overlap risk' case.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.