CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-development

This skill should be used when the user asks to "create an agent", "write an agent", "build an agent", or wants to add new agent capabilities to Claude Code.

80

1.84x
Quality

Does it follow best practices?

Impact

96%

1.84x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The body is concise and well-organized for a simple reference skill, but it describes agent attributes (colors, resilience, hot-reload) rather than giving an actionable, sequenced workflow for actually creating an agent.

Suggestions

Add a short numbered creation workflow (write frontmatter with name/description/color, define behavior, save under the agents directory, confirm hot-reload) so the single action is unambiguous.

Replace the descriptive 'Permission Denial Resilience' paragraph with an actionable instruction or a concrete behavior-pattern snippet the author should encode.

DimensionReasoningScore

Conciseness

The body is lean with no preamble about what an agent is; the color table and behavior notes are information-dense and every section earns its tokens, matching the 'lean and efficient' anchor.

3 / 3

Actionability

A concrete YAML frontmatter example with 'color: purple' is provided, but the actual agent-creation process is otherwise descriptive — 'Permission Denial Resilience' describes a behavior without actionable instruction, leaving key creation details missing.

2 / 3

Workflow Clarity

Although it is a simple skill, the body is a reference (colors, behaviors) rather than a sequenced creation process, so the single action of creating an agent is not unambiguously laid out and there is no explicit sequence.

2 / 3

Progressive Disclosure

Under 50 lines with no external references needed, the content is split into well-organized sections (Colors, Behavior, Important), meeting the simple-skill bar for a 3.

3 / 3

Total

10

/

12

Passed

Description

72%

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

The description has strong, natural trigger terms and a clear niche, but it answers 'when' thoroughly while leaving 'what it does' implicit, and its action verbs are variations on one capability rather than a list of distinct concrete actions.

Suggestions

Lead with what the skill does, e.g. 'Create effective Claude Code agents by defining YAML frontmatter (name, description, color) and behavior.' before the 'Use when...' clause.

Enumerate distinct capabilities (e.g. color assignment, hot-reloading, permission-denial resilience) rather than restating 'create/write/build an agent' as separate triggers.

DimensionReasoningScore

Specificity

Names the agent domain with concrete verbs ('create an agent', 'write an agent', 'build an agent', 'add new agent capabilities') but these are synonymous trigger phrases rather than multiple distinct capabilities like the score-3 anchor, so it stops at 'domain and some actions'.

2 / 3

Completeness

The 'when' is explicit ('This skill should be used when the user asks to...') but the 'what' is never stated in the description — it only says when to use it, not what it does, capping completeness at 2 per the guideline.

2 / 3

Trigger Term Quality

Direct quoted user phrasings ('create an agent', 'write an agent', 'build an agent') are exactly what a user would naturally say, giving good coverage of natural trigger terms.

3 / 3

Distinctiveness Conflict Risk

'agent' scoped to 'Claude Code' with explicit trigger phrases carves a clear niche unlikely to conflict with unrelated skills.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
dwmkerr/claude-toolkit
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.