Use when creating new skills, editing existing skills, or verifying skills work before deployment
73
62%
Does it follow best practices?
Impact
93%
1.86xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.opencode/skills/writing-skills/SKILL.mdSkill structure and frontmatter
Name: allowed characters
50%
100%
Name: verb-first form
0%
87%
Frontmatter: exactly two fields
0%
100%
Description: starts with 'Use when'
0%
100%
Description: third person
0%
100%
Description: no workflow summary
0%
100%
Description: length
0%
100%
Section: Quick Reference
62%
100%
Section: Common Mistakes
37%
100%
Code: single language
100%
100%
Code: complete, not templated
100%
100%
File organization and cross-referencing
Heavy reference extracted
100%
100%
Reference file linked
100%
100%
No @ link syntax
0%
100%
Explicit cross-reference markers
0%
100%
Short code kept inline
100%
100%
Single language code
50%
0%
SKILL.md word count reduced
100%
100%
Flat directory structure
100%
100%
Discipline skill bulletproofing
Rationalization table
50%
100%
Red Flags section
83%
100%
Spirit vs letter principle
16%
100%
Authority language
90%
100%
No exceptions clause
100%
100%
Named rationalizations countered
91%
100%
Description: starts with 'Use when'
100%
100%
Description: violation triggers
0%
100%
Description: no workflow summary
0%
100%
Requirement is absolute
100%
100%
f062bf8
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.