Skill Audit

Audit a skill before calling it ready. Favor Tessl output, repo conventions, and the skill's actual file shape over taste.

Tessl is the skill-evaluation CLI this repo uses to review skills, score their quality, and suggest improvements. See tessl.io and the CLI docs. If npx tessl ... or tessl ... is unavailable, install or initialize Tessl before running the audit loop.

Principles

• Evidence beats hunches
• Discovery matters: score name and description before polishing the body
• Keep SKILL.md lean; move depth into references/ or scripts only when they earn their keep
• Prefer the smallest change set that improves activation, clarity, or verification
• Audit only the requested scope; flag adjacent issues separately

Handoffs

• Need to update AGENTS, README, or other repo docs beyond the skill surface -> use docs
• Need to prove a product or code change works on real surfaces -> use verify
• Need to review general code or a PR instead of a skill package -> use review