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.
71
52%
Does it follow best practices?
Impact
79%
1.25xAverage score across 7 eval scenarios
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 has good completeness with an explicit 'Use when' clause covering both creation and updating scenarios. However, it lacks specificity about what concrete actions the skill performs (e.g., generating frontmatter, structuring markdown, defining triggers). The trigger terms are adequate but could be expanded with more natural variations users might employ.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Guides creation of SKILL.md files including YAML frontmatter, description fields, and markdown instruction blocks'
Expand trigger terms to include natural variations like 'SKILL.md', 'skill file', 'teach Claude how to', 'custom workflow', or 'skill template'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description says 'creating effective skills' and 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' but these are vague and abstract. No concrete actions like 'generates YAML frontmatter', 'writes markdown instructions', or 'validates skill structure' are mentioned. | 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 | Includes 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', 'teach Claude', 'custom instruction', or 'skill template'. | 2 / 3 |
Distinctiveness Conflict Risk | The skill is somewhat distinctive in targeting skill creation specifically, but the vague language about 'specialized knowledge, workflows, or tool integrations' could overlap with general documentation or configuration skills. The term 'skill' as a trigger is fairly specific to this domain though. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive and well-structured workflow for creating skills, with clear step sequencing and validation checkpoints. However, it significantly violates its own core principle of conciseness—it's verbose, explains many concepts Claude already understands, and includes substantial inline content that should be split into reference files per its own progressive disclosure guidance. The actionability is moderate, with good structural examples but abstract writing guidance.
Suggestions
Cut the 'About Skills' and 'What Skills Provide' sections entirely—Claude already knows what skills are from the system prompt, and this information is redundant with the structural guidance that follows.
Move the detailed 'Progressive Disclosure Design Principle' patterns and 'Bundled Resources' explanations into a references/skill-design-patterns.md file, keeping only a brief summary and link in SKILL.md.
Replace abstract guidance like 'Write instructions for using the skill' in Step 4 with a concrete, minimal SKILL.md example showing a complete frontmatter + body for a simple skill.
Condense the 'Set Appropriate Degrees of Freedom' section to a 3-line bullet list—the bridge/field metaphor and detailed explanations add tokens without adding actionable value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines, with significant portions explaining concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets mean conceptually). Sections like 'What Skills Provide' and 'About Skills' are largely unnecessary. Many paragraphs could be condensed to single sentences or bullet points. | 1 / 3 |
Actionability | The skill provides concrete commands for init_skill.py and package_skill.py with usage examples, and includes structural examples (directory layouts, markdown patterns). However, much of the guidance remains abstract ('Write instructions for using the skill,' 'Include information that would be beneficial and non-obvious to Claude') rather than providing executable templates or concrete SKILL.md writing examples with before/after comparisons. | 2 / 3 |
Workflow Clarity | The 6-step creation process is clearly sequenced with explicit ordering ('Follow these steps in order, skipping only if there is a clear reason'), includes validation via the packaging script (Step 5), has clear skip conditions for steps, and includes an iteration feedback loop (Step 6). The packaging step explicitly validates before creating output and reports errors for fixing. | 3 / 3 |
Progressive Disclosure | The skill references external files (references/workflows.md, references/output-patterns.md) with clear signals for when to consult them, which is good. However, the SKILL.md itself is a monolithic wall of text that violates its own advice about keeping SKILL.md under 500 lines and splitting content. Much of the detailed guidance about progressive disclosure patterns, bundled resources, and design principles could be moved to reference files. | 2 / 3 |
Total | 8 / 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.
3ce3191
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.