This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
67
53%
Does it follow best practices?
Impact
93%
1.60xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/plugin-dev/skills/skill-development/SKILL.mdQuality
Discovery
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 is strong on trigger terms and distinctiveness, providing clear natural-language phrases users would say and targeting a specific niche. However, it is weak on explicitly describing what the skill actually does — it reads more like a list of trigger conditions than a capability description. The 'what' and 'when' are conflated rather than clearly separated.
Suggestions
Add an explicit 'what it does' statement before the trigger clause, e.g., 'Guides users through creating, structuring, and improving SKILL.md files for Claude Code plugins, including writing descriptions, organizing content with progressive disclosure, and following best practices.'
Separate the capability description from the trigger guidance — first state what the skill does (concrete actions/outputs), then state when to use it with the trigger phrases.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (skill creation for Claude Code plugins) and mentions some actions like 'create a skill', 'improve skill description', 'organize skill content', but it doesn't list concrete specific capabilities beyond these quoted trigger phrases. It references concepts like 'progressive disclosure' and 'skill development best practices' but doesn't explain what concrete actions the skill performs. | 2 / 3 |
Completeness | The description has a 'Use when' clause (it starts with 'This skill should be used when...'), but the 'what does this do' part is weak — it mostly lists trigger scenarios rather than clearly describing the skill's capabilities or outputs. The 'what' is only implied through the trigger terms rather than explicitly stated. | 2 / 3 |
Trigger Term Quality | The description includes multiple natural trigger phrases users would actually say: 'create a skill', 'add a skill to plugin', 'write a new skill', 'improve skill description', 'organize skill content'. These are realistic user utterances and cover several common variations of the request. | 3 / 3 |
Distinctiveness Conflict Risk | The description targets a very specific niche — creating and managing skills for Claude Code plugins. The trigger terms are distinct and unlikely to conflict with other skills, as they specifically reference 'skill' creation, plugin development, and skill structure concepts like 'progressive disclosure'. | 3 / 3 |
Total | 10 / 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 skill is deeply ironic: it teaches how to write lean, well-organized skills while itself being verbose, repetitive, and poorly organized. The same concepts (third-person descriptions, imperative writing, progressive disclosure, trigger phrases) are repeated across 4-6 different sections. The core workflow (Steps 1-6) is solid but buried in excessive surrounding material that violates the skill's own 1,500-2,000 word target.
Suggestions
Reduce SKILL.md to 1,500-2,000 words by moving 'Common Mistakes to Avoid', 'Writing Style Requirements', 'Progressive Disclosure in Practice', and 'Quick Reference' sections to references/ files, following the skill's own advice.
Eliminate redundancy: the writing style guidance (imperative form, third person) appears in Steps 4, 5, 'Writing Style Requirements', 'Common Mistakes', 'Validation Checklist', and 'Best Practices Summary'—consolidate to one authoritative location.
Add concrete validation scripts or commands in Step 5 rather than just a checklist of things to manually verify (e.g., a script to count SKILL.md word count, check frontmatter format, verify referenced files exist).
Remove explanations of concepts Claude already knows, such as what scripts/references/assets are, what progressive disclosure means conceptually, and basic file organization principles—focus only on the specific conventions and decisions unique to this plugin system.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At roughly 3,000+ words, this skill is extremely verbose and repetitive. It explains concepts Claude already knows (what a PDF is, what scripts are, what progressive disclosure means), repeats the same advice multiple times (writing style requirements appear in at least 3 separate sections, trigger phrase guidance is repeated 4+ times), and includes extensive 'bad vs good' examples that belabor obvious points. The same information about keeping SKILL.md lean, using third person, and imperative form is restated across multiple sections. | 1 / 3 |
Actionability | The skill provides some concrete guidance like directory structure commands and YAML frontmatter examples, but much of the content is meta-guidance about how to write skills rather than executable code. The mkdir commands and YAML examples are copy-paste ready, but the bulk is descriptive advice rather than concrete, executable steps. There's no actual script code or validation tooling provided inline. | 2 / 3 |
Workflow Clarity | The 6-step creation process (Steps 1-6) provides a clear sequence, and Step 5 includes a validation checklist. However, the validation step lacks concrete executable commands for most checks (e.g., 'Check trigger phrases' has no automated way to verify). The feedback loop in Step 6 is mentioned but vague. The workflow is spread across many sections making it hard to follow linearly. | 2 / 3 |
Progressive Disclosure | The skill references `references/skill-creator-original.md` and points to sibling skills as examples, which is good. However, no bundle files are provided, so we can't verify these exist. More critically, the SKILL.md itself violates its own advice by being far too long—it should move the detailed 'Common Mistakes', 'Writing Style Requirements', extensive examples, and 'Progressive Disclosure in Practice' sections to reference files. The content that should be in references/ is inline. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (638 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
76b35e9
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.