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.
79
70%
Does it follow best practices?
Impact
96%
1.07xAverage score across 3 eval scenarios
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/coding-agents-and-ides/skill-creator/SKILL.mdNew skill creation with init and packaging scripts
Used init_skill.py
100%
100%
Used package_skill.py
100%
100%
.skill file exists
100%
100%
Rotation script in scripts/
100%
100%
SKILL.md frontmatter has name and description
100%
100%
When-to-use in frontmatter description
100%
100%
No when-to-use section in body
0%
100%
Imperative/infinitive form
75%
100%
No extra documentation files
0%
100%
Script referenced in SKILL.md
100%
100%
No other frontmatter fields
100%
100%
Low-freedom skill design for a fragile sequential workflow
Script(s) in scripts/
100%
100%
Script referenced in SKILL.md
100%
100%
Sequential steps visible in SKILL.md
100%
100%
Frontmatter name and description
100%
100%
When-to-use in description
100%
100%
No 'When to Use' section in body
100%
100%
Imperative/infinitive form
100%
100%
No extra documentation files
100%
100%
Low-freedom design justified
100%
100%
SKILL.md is concise
100%
100%
No other frontmatter fields
100%
100%
Progressive disclosure refactor of an overgrown skill
SKILL.md under 500 lines
100%
100%
Domain content in references/
100%
100%
No 'When to Use' in body
0%
0%
No schema duplication
100%
100%
References linked with when-to-read
78%
100%
No extra documentation files
100%
100%
Description has when-to-use
100%
100%
Lean SKILL.md body
100%
100%
refactor-notes.md created
100%
100%
Original not modified
100%
100%
9be8efc
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.