CtrlK
BlogDocsLog inGet started
Tessl Logo

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

1.25x

Quality

100%

Does it follow best practices?

Impact

88%

1.25x

Average score across 12 eval scenarios

Overview
Skills
Evals
Files

rubric.jsonevals/scenario-9/

{
  "context": "Tests whether the agent correctly implements the approval-before-application workflow: producing a proposal document with priority-ordered recommendations, per-recommendation details (current score, issue, before/after, impact, WHY), without actually editing the SKILL.md file.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "SKILL.md not modified",
      "description": "The output does NOT include a modified SKILL.md file — only the proposal document is produced",
      "max_score": 20
    },
    {
      "name": "Priority summary present",
      "description": "proposal.md includes a summary section grouping recommendations by priority (Critical/High/Medium) with expected overall improvement",
      "max_score": 12
    },
    {
      "name": "Expected improvement in summary",
      "description": "The summary section quantifies the expected score improvement (e.g. percentage gain) if all recommendations are applied",
      "max_score": 8
    },
    {
      "name": "Current score per recommendation",
      "description": "Each recommendation states the current dimension score (e.g. 'Completeness: 1/3 (33%)')",
      "max_score": 10
    },
    {
      "name": "Before/after per recommendation",
      "description": "Each recommendation includes a before example (current text) and after example (proposed text)",
      "max_score": 12
    },
    {
      "name": "Impact per recommendation",
      "description": "Each recommendation states the expected score impact of that specific change",
      "max_score": 8
    },
    {
      "name": "Educational WHY per recommendation",
      "description": "Each recommendation includes an explanation of WHY the change improves the skill quality — not just what to change",
      "max_score": 12
    },
    {
      "name": "Critical first",
      "description": "The missing 'Use when...' clause recommendation appears first (Critical priority)",
      "max_score": 10
    },
    {
      "name": "Approval framing",
      "description": "Document is explicitly framed as a proposal for review/approval, not a record of changes already made",
      "max_score": 8
    }
  ]
}

Install with Tessl CLI

npx tessl i tessl-labs/skill-optimizer

evals

tile.json