tessl-labs/skill-optimizer
Improves your SKILL.md using tessl skill review plus validation and context. Reads skill bundle (SKILL.md + related files), validates syntax, explains WHY changes help, catches mistakes. Use when improving your own skill, skill file, skill description, reviewing skill quality, skill scoring, making your skill better, or learning the skill rubric.
89
Quality
100%
Does it follow best practices?
Impact
88%
1.25xAverage score across 12 eval scenarios
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly communicates its purpose, lists concrete actions, and provides explicit trigger guidance. It uses appropriate third-person voice and includes natural keywords users would actually say. The description effectively distinguishes itself from other skills through its specific focus on SKILL.md improvement.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Reads skill bundle', 'validates syntax', 'explains rubric', 'shows before/after scores'. These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Improves your SKILL.md file with actionable recommendations', lists specific actions) AND when (explicit 'Use when...' clause with multiple trigger scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'SKILL.md', 'skill file', 'skill description', 'skill quality', 'skill scoring', 'making your skill better', 'skill rubric'. These are terms users would naturally use when seeking this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche focused specifically on SKILL.md files and skill improvement. The specific terminology ('SKILL.md', 'skill rubric', 'skill scoring') makes it highly unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill that practices what it preaches. It demonstrates excellent conciseness while remaining highly actionable, with a clear multi-phase workflow including validation checkpoints and verification steps. The meta-nature of the skill (teaching how to improve skills) is handled elegantly without becoming self-referential or verbose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, assuming Claude's competence throughout. No unnecessary explanations of basic concepts—it jumps straight into actionable workflow phases with minimal preamble. | 3 / 3 |
Actionability | Provides concrete, executable commands (tessl skill review, bash scripts for orphan detection), specific validation steps, and clear before/after examples. The workflow phases are copy-paste ready. | 3 / 3 |
Workflow Clarity | Excellent 8-phase workflow with explicit validation checkpoints (Phase 4, Phase 8), clear sequencing, and feedback loops (re-run review to verify improvement). Prioritization framework (Critical→High→Medium→Low) adds structure. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections, references REFERENCE.md for detailed validation examples with routing signal ('for detailed validation examples and common mistakes'), and teaches the principle of progressive disclosure itself. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Install with Tessl CLI
npx tessl i tessl-labs/skill-optimizer@0.5.0Reviewed
Table of Contents