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
67%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/skill-creator/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7aff694
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.