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.
83
76%
Does it follow best practices?
Impact
97%
1.27xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skill-creator/SKILL.mdSKILL.md authoring conventions
Third-person description
0%
100%
No allowed-tools field
0%
100%
Imperative writing style
100%
100%
No version history section
100%
100%
Informative reference filename
83%
100%
SKILL.md link updated
100%
100%
No content duplication
0%
33%
Skill name unchanged
100%
100%
Issues documented
100%
100%
Inline vs fork skill architecture
Orchestrator is inline
100%
100%
Specialist uses fork
0%
100%
Orchestrator references Task tool
100%
100%
Orthogonal concerns
100%
100%
No allowed-tools in orchestrator
100%
100%
No allowed-tools in specialist
100%
100%
Third-person descriptions
0%
100%
No manual capability flags
100%
100%
Imperative writing style
100%
100%
Design rationale documented
100%
100%
Skill packaging and marketplace distribution
No absolute paths
100%
100%
No version history
0%
100%
Reference file renamed
100%
100%
SKILL.md link updated
100%
100%
Missing script reference resolved
100%
100%
marketplace.json exists
100%
100%
marketplace.json required fields
50%
100%
Semver version
100%
100%
Security scan documented
100%
100%
Packaging step documented
100%
100%
4f0eae8
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.