CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-development

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.

77

1.60x
Quality

70%

Does it follow best practices?

Impact

93%

1.60x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/plugin-dev/skills/skill-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%Weight 40%Scale 1-5

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

The body delivers an explicit, well-sequenced creation workflow with real validation checkpoints and mostly concrete, executable guidance. Its dominant weakness is verbosity: at ~3,150 words it breaks its own lean-body rule and repeats the same style/organization rules across five separate sections, while inlining content that should live in references/.

Suggestions

Collapse "Writing Style Requirements", "Common Mistakes", "Validation Checklist", and "Best Practices Summary" into a single non-redundant section (or move them to a references/ file) to cut the body to the 1,500-2,000 words the skill itself prescribes.

Practice the skill's own progressive-disclosure principle: move the mistake galleries, style example blocks, and quick-reference layouts into references/ files and keep only pointers in SKILL.md.

Replace the vague skill-reviewer agent invocation ("Ask: 'Review my skill...'") with the concrete path or command needed to actually run it, and drop or verify the sibling-skill pointers like `../hook-development/`.

DimensionReasoningScore

Conciseness

The body is ~3,150 words, violating its own guidance ("Keep under 3,000 words, ideally 1,500-2,000"), and restates the same rules repeatedly — third-person descriptions, imperative form, and lean SKILL.md each appear across "Skill Creation Process", "Writing Style Requirements", "Common Mistakes", "Validation Checklist", and "Best Practices Summary". It also explains background concepts Claude already knows (what skills are, generic directory-tree walkthroughs). This matches 'noticeably verbose; several unnecessary explanations or padded sections', not 3, because the redundancy is systematic rather than isolated.

2 / 5

Actionability

Concrete executable guidance throughout: mkdir/touch commands, a YAML frontmatter template, paired good/bad description examples, and a runnable test command ("cc --plugin-dir /path/to/plugin"). Minor gaps keep it below 5: the "skill-reviewer agent" invocation is vague ("Ask: 'Review my skill...'" with no path or command), and sibling-skill pointers like `../hook-development/` are unverifiable from the bundle.

4 / 5

Workflow Clarity

The six-step creation process is explicitly sequenced with a dedicated validation step (8-point checklist covering structure, description quality, content quality, and progressive disclosure) and an iteration loop (use → notice struggles → update → retest). This matches the anchor for clear sequence, explicit validation steps, feedback loops, and checklists. Not below 5 despite the vague skill-reviewer aside, which supplements rather than replaces the concrete checklist.

5 / 5

Progressive Disclosure

The single bundle reference (`references/skill-creator-original.md`) exists, is clearly signposted one level deep, and the body is well-sectioned with headers and a Quick Reference. Not 5 because substantial material that the skill's own rules would place in references/ (the mistakes gallery, writing-style example blocks, quick-reference layouts) is inlined in the body, which runs ~3,150 words; not 3 because navigation is clear and the actual bundle reference is properly structured and referenced.

4 / 5

Total

15

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong third-person description with explicit, natural trigger phrases and a clearly scoped domain. Its main weakness is that it characterizes when the user needs it rather than stating what the skill itself provides, so the capability side is implicit.

Suggestions

Add a brief capability clause stating what the skill provides, e.g., "Provides a step-by-step skill creation process, structure templates, description-writing guidance, and a validation checklist."

Include a few more natural trigger variations such as "make a skill", "skill template", or "SKILL.md" to broaden keyword coverage.

DimensionReasoningScore

Specificity

Multiple concrete trigger actions are quoted ("create a skill", "write a new skill", "improve skill description", "organize skill content") and the domain is named precisely, but the description never states what the skill itself provides (e.g., step-by-step creation process, structure templates, validation checklists), leaving minor gaps in coverage. Not 5 because the capability side is thin; not 3 because more than 1-2 concrete actions are listed.

4 / 5

Completeness

The 'when' is explicit and concrete (quoted trigger phrases plus "needs guidance on skill structure, progressive disclosure..."), but the 'what' is only indirectly stated — the description characterizes the user's need rather than declaring the skill's capabilities. Not 5 because the 'what' could be more explicit; not 3 because both elements are present.

4 / 5

Trigger Term Quality

Good natural phrasing coverage ("create a skill", "add a skill to plugin", "improve skill description") that mirrors what users would say. Not 5 because common variations like "make a skill", "skill template", or "SKILL.md" are missing; not 3 because the quoted phrases cover the primary phrasings well.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (skill authoring for Claude Code plugins) and trigger phrases are distinct. Minor overlap risk with adjacent skills like hook-development, agent-development, or plugin-structure skills, which share the "create/improve" verb pattern. Not 5 due to that adjacent-skill overlap; not 3 because the domain scoping is specific.

4 / 5

Total

16

/

20

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 — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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

referenced_paths_exist

Referenced path issues: 26 missing, 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository
anthropics/claude-plugins-official
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.