CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

74

Quality

67%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

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 succeeds at providing explicit 'when to use' guidance but falls short on specificity of what the skill actually does. It reads more like a high-level summary than a concrete capability listing. The trigger terms are adequate but could be expanded with more natural user phrasings.

Suggestions

Replace the vague 'Guide for creating effective skills' with specific actions like 'Generates skill files with YAML frontmatter, writes markdown instructions, validates skill structure and format'.

Add more natural trigger term variations such as 'SKILL.md', 'skill file', 'skill template', 'write a skill', or 'define a new capability'.

DimensionReasoningScore

Specificity

The description says 'creating effective skills' and 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' but doesn't list concrete actions like 'generates YAML frontmatter, writes markdown instructions, validates skill structure.' The language is abstract and vague about what the skill actually does.

1 / 3

Completeness

The description answers both 'what' (guide for creating effective skills that extend Claude's capabilities) and 'when' ('should be used when users want to create a new skill or update an existing skill'). The 'when' clause is explicit with clear triggers.

3 / 3

Trigger Term Quality

Contains some relevant trigger terms like 'create a new skill', 'update an existing skill', and 'skill' itself. However, it misses natural variations users might say such as 'SKILL.md', 'skill file', 'write a skill', 'skill template', or 'skill format'.

2 / 3

Distinctiveness Conflict Risk

The term 'skill' is fairly specific to this domain, but the description's vagueness about what it actually does ('specialized knowledge, workflows, or tool integrations') could overlap with general documentation or template-creation skills. It's somewhat distinguishable but not sharply defined.

2 / 3

Total

8

/

12

Passed

Implementation

77%

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

This is a well-structured, actionable skill with a clear 6-step workflow and concrete examples. Its main weakness is verbosity in the introductory 'About Skills' section, which explains concepts (what skills are, what they provide) that Claude already understands, consuming significant token budget. The procedural content (Steps 1-6) is strong with executable commands, worked examples, and validation checkpoints.

Suggestions

Move the 'About Skills' section (anatomy, resource types, progressive disclosure principle) to a references/skill-anatomy.md file and keep only a brief summary in SKILL.md, reducing token usage significantly.

Trim explanatory phrases like 'Think of them as onboarding guides for specific domains' and 'What Skills Provide' list—Claude already understands these concepts and the procedural steps make them implicit.

DimensionReasoningScore

Conciseness

The skill contains some unnecessary explanations (e.g., 'Think of them as onboarding guides' and the 'What Skills Provide' section explains concepts that Claude already understands). The 'About Skills' section is largely educational padding. However, the procedural steps themselves are reasonably efficient.

2 / 3

Actionability

The skill provides concrete, executable commands (init_skill.py, package_skill.py with exact CLI syntax), specific file structure examples, clear questions to ask users, and worked examples for different skill types (pdf-editor, frontend-webapp-builder, big-query). The guidance is specific and directly usable.

3 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced with explicit conditions for skipping steps, validation is built into the packaging step (Step 5) with a fix-and-retry feedback loop, and each step has clear completion criteria. The workflow handles the full lifecycle from understanding through iteration.

3 / 3

Progressive Disclosure

The content is well-structured with clear headers and sections, but the 'About Skills' section (anatomy, progressive disclosure principle, resource types) is quite lengthy and could be moved to a reference file. The skill is monolithic at ~200+ lines when the procedural core (Steps 1-6) could stand alone with background material referenced separately.

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
sc30gsw/claude-code-customes
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.