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
{
"context": "Tests whether the agent correctly identifies and applies the three key scoring dimensions with their weights (Completeness 35%, Conciseness 30%, Actionability 30%), correctly identifies the missing 'Use when...' clause as the highest-impact fix, recommends executable code over abstract prose, and flags known-concept content that reduces conciseness.",
"type": "weighted_checklist",
"checklist": [
{
"name": "Completeness weight correct",
"description": "Plan states that Completeness has the highest weight (35%) among the dimensions",
"max_score": 10
},
{
"name": "Conciseness weight correct",
"description": "Plan states Conciseness is 30% weight",
"max_score": 8
},
{
"name": "Actionability weight correct",
"description": "Plan states Actionability is 30% weight",
"max_score": 8
},
{
"name": "Use when clause highest impact",
"description": "Plan identifies adding a 'Use when...' clause as the highest-priority or highest-impact change",
"max_score": 15
},
{
"name": "Use when quantified",
"description": "Plan states that the missing 'Use when...' clause adds approximately +15% to overall score (or is flagged as the most valuable single change)",
"max_score": 10
},
{
"name": "Revised description includes Use when",
"description": "The revised description block in the output includes a 'Use when...' clause (e.g. 'Use when you need to retrieve, rotate, or audit secrets...')",
"max_score": 12
},
{
"name": "Executable code recommended",
"description": "Plan recommends replacing abstract prose instructions with executable code examples (for actionability)",
"max_score": 12
},
{
"name": "Known concepts flagged",
"description": "Plan identifies that the existing prose explains things an agent already knows (e.g. 'don't hardcode secrets', 'use environment variables') as reducing Conciseness",
"max_score": 10
},
{
"name": "High-impact first ordering",
"description": "Quick wins are ordered so the highest-impact item (Use when clause) appears first",
"max_score": 10
},
{
"name": "Dimension coverage",
"description": "Plan covers all three main scoring dimensions (Completeness, Conciseness, Actionability) with separate assessments",
"max_score": 5
}
]
}Install with Tessl CLI
npx tessl i tessl-labs/skill-optimizer@0.5.0evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
scenario-8
scenario-9
scenario-10
scenario-11
scenario-12
skills
skill-optimizer