CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-creator

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

83

Quality

81%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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 exceptionally thorough and actionable with a well-structured multi-phase workflow and strong validation checkpoints. However, it severely suffers from verbosity — at 600+ lines it inlines extensive reference material (schema tables, model guides, permission guides, 10 common mistakes, full testing procedures) that should live in the referenced files (agent-schema.md, agent-templates.md). The content is high quality but would be far more effective at 1/3 the length with proper delegation to reference files.

Suggestions

Move the Agent Frontmatter Schema, Model Selection Guide, Permission Mode Guide, Tool Access Patterns, and Description Writing Guide sections into the already-referenced `references/agent-schema.md` file, keeping only a 1-2 line summary with a link in the main SKILL.md.

Move the 10 Common Mistakes and Testing sections into a separate `references/agent-troubleshooting.md` file, retaining only the Phase 6 validation checklist inline.

Consolidate the Common Agent Patterns and Anti-Patterns sections into `references/agent-templates.md` since that file is already referenced for template guidance.

Reduce the main SKILL.md to ~150-200 lines covering the 8-phase workflow with concise steps, the quick reference links, and the interaction protocol — everything else should be in reference files.

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~600+ lines. It explains many concepts Claude already knows (what a PDF library is, how YAML works, what 'read-only' means). Sections like 'Common Mistakes' enumerate 10 detailed mistakes with extensive explanations, tables repeat information already covered, and the testing section is exhaustive beyond what's needed. Much of this content (permission modes, model selection, tool patterns) could be condensed to compact reference tables or offloaded to reference files.

1 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific bash commands for discovery, exact YAML frontmatter examples, complete agent file templates with all fields, specific validation commands (skilllint, claude plugin validate), and copy-paste ready configuration patterns. Every phase includes specific actions to take.

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), explicit verification steps (checking plugin.json wasn't modified, running skilllint), and clear decision points with AskUserQuestion gates between phases.

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 should 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, 10 common mistakes, and extensive testing guidance. The main SKILL.md should be a concise overview pointing to these references rather than duplicating their content.

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1076 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

Repository
Jamie-BitFlight/claude_skills
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.