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 runs all five Phase 8 final accuracy checks: code syntax validity, command flag correctness, file reference existence, 'Use when...' clause in description, and absence of concepts the agent already knows. The SKILL.md has a Python syntax error, a missing Use-when clause, and explanatory text about known concepts (HTTP/TCP).",
"type": "weighted_checklist",
"checklist": [
{
"name": "Code syntax check included",
"description": "Report includes a dedicated check for code syntax validity (covering Python, JavaScript, or bash code blocks)",
"max_score": 10
},
{
"name": "Python syntax error found",
"description": "Report correctly identifies the Python syntax error (missing closing parenthesis in `json.loads(result.stdout`)",
"max_score": 15
},
{
"name": "Command flags check included",
"description": "Report includes a dedicated check for command flag correctness (validating logq or other command flags)",
"max_score": 8
},
{
"name": "File references check included",
"description": "Report includes a dedicated check for whether all linked files exist",
"max_score": 8
},
{
"name": "File reference passes",
"description": "Report correctly identifies that QUERY_PATTERNS.md reference passes (file exists in the bundle)",
"max_score": 8
},
{
"name": "Use when clause check included",
"description": "Report includes a dedicated check for whether the description contains a 'Use when...' trigger clause",
"max_score": 12
},
{
"name": "Use when clause fails",
"description": "Report correctly identifies that the description is MISSING a 'Use when...' clause (current description doesn't start with or include 'Use when')",
"max_score": 12
},
{
"name": "Known concepts check included",
"description": "Report includes a dedicated check for whether the skill explains concepts that an agent already knows",
"max_score": 10
},
{
"name": "Known concepts issue found",
"description": "Report flags the HTTP/TCP explanation ('HTTP is a stateless request/response protocol...') as content an agent already knows",
"max_score": 12
},
{
"name": "Readiness summary",
"description": "Report ends with a clear summary of whether the skill is ready to publish or lists required fixes first",
"max_score": 5
}
]
}Install with Tessl CLI
npx tessl i tessl-labs/skill-optimizerevals
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