Create high-quality Claude Code agents from scratch or by adapting existing agents as templates. Use when the user wants to create a new agent, modify agent configurations, build specialized subagents, or design agent architectures. Guides through requirements gathering, template selection, and agent file generation following Anthropic best practices (v2.1.63+).
66
81%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that clearly communicates what the skill does and when to use it. It uses third-person voice, lists specific concrete actions, includes natural trigger terms, and has an explicit 'Use when...' clause. The specificity around Claude Code agents and version numbering makes it highly distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create high-quality Claude Code agents from scratch', 'adapting existing agents as templates', 'modify agent configurations', 'build specialized subagents', 'design agent architectures', and 'requirements gathering, template selection, and agent file generation'. | 3 / 3 |
Completeness | Clearly answers both 'what' (create agents from scratch or templates, modify configurations, build subagents, design architectures) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios. Also describes the process (requirements gathering, template selection, file generation). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'create a new agent', 'modify agent configurations', 'build specialized subagents', 'design agent architectures', 'template selection', 'agent file generation'. These cover the natural ways users would phrase requests about agent creation. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche focused specifically on Claude Code agent creation and configuration. The mention of 'Claude Code agents', 'subagents', 'agent architectures', and 'Anthropic best practices (v2.1.63+)' makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is highly actionable with an excellent multi-phase workflow including proper validation checkpoints and safety guards (especially the plugin.json auto-discovery protection). However, it is severely over-long, inlining extensive reference material that should live in the referenced files (agent-schema.md, agent-templates.md, agent-examples.md). The 10 common mistakes, extensive testing section, and duplicated guidance patterns (anti-patterns vs common mistakes) make this a significant token burden that undermines its otherwise strong structure.
Suggestions
Move the inline schema tables, model/permission/tool guides, common patterns, and anti-patterns into the referenced files (references/agent-schema.md, references/agent-templates.md) and keep only brief summaries with links in SKILL.md
Consolidate 'Anti-Patterns to Avoid' and 'Common Mistakes' into a single concise section — they overlap significantly (e.g., vague descriptions, wrong permissions, missing tool restrictions appear in both)
Reduce the Testing section to a compact checklist and move detailed testing methods/edge cases to a separate references/agent-testing.md file
Remove explanatory prose that Claude already knows (e.g., what XML tags are, how YAML works, what 'read-only' means) and trust Claude's competence with terse instructions
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~600+ lines. It explains many concepts Claude already knows (what a PDF library is, how to write YAML, what permission modes mean conceptually). Massive sections like 'Common Mistakes' with 10 detailed mistakes, extensive testing guidance, and repeated information (anti-patterns + common mistakes overlap significantly) bloat the token budget enormously. Much of this could be condensed to tables and brief references. | 1 / 3 |
Actionability | The skill provides highly concrete, executable guidance throughout: specific bash commands for discovery, exact YAML configurations for every pattern, complete file templates with frontmatter structure, validation commands (skilllint, claude plugin validate), and specific AskUserQuestion prompts. The workflow phases are detailed with copy-paste ready examples. | 3 / 3 |
Workflow Clarity | The 8-phase workflow is clearly sequenced with explicit validation checkpoints (Phase 6 validation checklist, Phase 8 post-creation validation). It includes feedback loops (iterative testing process), error recovery guidance (common test failures table), and critical safety checks like the plugin.json auto-discovery rule with incident history. Destructive operations (plugin.json modification) are explicitly guarded. | 3 / 3 |
Progressive Disclosure | The skill references external files (references/agent-schema.md, references/agent-templates.md, references/agent-examples.md) which is good progressive disclosure, but then proceeds to inline massive amounts of content that could live in those reference files — the full schema table, model selection guide, permission mode guide, tool access patterns, description writing guide, body best practices, common patterns, anti-patterns, common mistakes (10 detailed items), and extensive testing guidance. The SKILL.md should be a concise overview pointing to these references rather than duplicating their content inline. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (1078 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
4e61312
Table of Contents
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.