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.
64
46%
Does it follow best practices?
Impact
96%
1.31xAverage score across 3 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 succeeds in providing explicit 'when to use' guidance but falls short on specificity of what concrete actions the skill performs. It reads more like a high-level summary than a detailed capability listing, using abstract language like 'extends capabilities' instead of naming concrete outputs or steps. The trigger terms are adequate but could be expanded with more natural variations.
Suggestions
Replace vague capability language with specific actions, e.g., 'Generates SKILL.md files with proper YAML frontmatter, writes structured markdown content, validates skill format and description quality'.
Add more natural trigger term variations such as 'SKILL.md', 'skill file', 'teach Claude', 'custom skill', 'skill template' to improve matching coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'creating effective skills' and 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations' without listing concrete actions. It doesn't specify what the skill actually does (e.g., generates YAML frontmatter, writes markdown templates, validates skill structure). | 1 / 3 |
Completeness | It explicitly answers both 'what' (guide for creating effective skills) and 'when' ('should be used when users want to create a new skill or update an existing skill'). The 'Use when' clause is clearly present with explicit triggers. | 3 / 3 |
Trigger Term Quality | It includes some relevant trigger terms like 'create a new skill', 'update an existing skill', and 'skill' itself, which users might naturally say. However, it misses variations like 'SKILL.md', 'skill file', 'custom instruction', 'teach Claude', or 'skill template'. | 2 / 3 |
Distinctiveness Conflict Risk | The term 'skill' provides some distinctiveness, but phrases like 'specialized knowledge, workflows, or tool integrations' are broad enough to potentially overlap with other meta-skills or documentation-related skills. It's somewhat specific to skill creation but could conflict with general documentation or template skills. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive meta-skill for creating skills, but it suffers from significant verbosity—it explains many concepts Claude already understands (what scripts are, what assets are, basic file organization) and includes redundant information across sections. The 6-step workflow is well-structured but lacks integrated validation checkpoints. The skill would benefit greatly from practicing what it preaches: moving detailed reference material into separate files and keeping SKILL.md lean with only essential procedural guidance.
Suggestions
Reduce verbosity by removing explanations of concepts Claude already knows (e.g., what PDFs are, what scripts/references/assets mean, what README files are) and trust Claude's intelligence—this could cut the content by 30-40%.
Move the detailed 'Progressive Disclosure Patterns' section and 'Core Principles' elaborations into a references/ file, keeping only a brief summary and link in SKILL.md—practice the progressive disclosure the skill itself teaches.
Add a concrete validation checkpoint between Step 4 (Edit) and Step 5 (Package)—e.g., a checklist of 'verify SKILL.md is under 500 lines, verify all referenced files exist, verify frontmatter description covers all triggers'.
Include a complete, minimal example of a finished SKILL.md (frontmatter + body) as a concrete reference, rather than only showing fragments across different sections.
| 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). Many sections contain redundant explanations—e.g., the 'What Skills Provide' list, the lengthy explanations of each resource type with multiple bullet points restating obvious information, and the 'What to Not Include' section listing specific filenames Claude doesn't need enumerated. | 1 / 3 |
Actionability | The skill provides concrete commands for init and packaging scripts (`scripts/init_skill.py`, `scripts/package_skill.py`) and includes structural examples of skill directories. However, much of the guidance remains at the level of principles and heuristics rather than executable steps—e.g., the 'Core Principles' section is largely conceptual, and the SKILL.md writing guidelines lack a concrete before/after example of a well-written skill body. | 2 / 3 |
Workflow Clarity | The 6-step creation process is clearly sequenced and each step is well-labeled. However, validation checkpoints are mostly delegated to the packaging script at Step 5 rather than being integrated throughout—there's no explicit checkpoint after Step 4 to verify SKILL.md quality before packaging, and the testing guidance in Step 4 ('Added scripts must be tested') lacks specific validation commands or criteria for success. | 2 / 3 |
Progressive Disclosure | The skill references `references/workflows.md` and `references/output-patterns.md` for additional patterns, which is good progressive disclosure. However, the SKILL.md itself is monolithic—much of the detailed content about resource types, progressive disclosure patterns, and design principles could be split into reference files. The extensive inline examples of directory structures and patterns bloat the main file significantly. | 2 / 3 |
Total | 7 / 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.
b6b34e6
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.