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-12/

{
  "context": "Tests whether the agent can identify orphaned files in a skill bundle (files that exist but are never referenced in SKILL.md) and provide appropriate recommendations. The bundle contains 8 files: SKILL.md references MIGRATIONS.md and POOLING.md, leaving 5 orphaned files (TRANSACTIONS.md, PERFORMANCE.md, SECURITY.md should be linked; LEGACY_EXAMPLES.md and DRAFT_REPLICATION.md should be removed).",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Lists all bundle files",
      "description": "Identifies all 8 files in the bundle (SKILL.md, MIGRATIONS.md, POOLING.md, TRANSACTIONS.md, PERFORMANCE.md, SECURITY.md, LEGACY_EXAMPLES.md, DRAFT_REPLICATION.md)",
      "max_score": 10
    },
    {
      "name": "Identifies referenced files",
      "description": "Correctly identifies that MIGRATIONS.md and POOLING.md are referenced in SKILL.md",
      "max_score": 10
    },
    {
      "name": "Identifies orphaned files",
      "description": "Correctly identifies all 5 orphaned files (TRANSACTIONS.md, PERFORMANCE.md, SECURITY.md, LEGACY_EXAMPLES.md, DRAFT_REPLICATION.md) - files that exist but are never linked from SKILL.md",
      "max_score": 15
    },
    {
      "name": "TRANSACTIONS.md recommendation",
      "description": "Recommends linking TRANSACTIONS.md (valuable content about atomic operations) with clear routing signals like 'for atomic operations and rollback patterns' or similar",
      "max_score": 10
    },
    {
      "name": "PERFORMANCE.md recommendation",
      "description": "Recommends linking PERFORMANCE.md (valuable optimization content) with clear routing signals like 'for indexing strategies and batch operation optimization' or similar",
      "max_score": 10
    },
    {
      "name": "SECURITY.md recommendation",
      "description": "Recommends linking SECURITY.md (valuable security content) with clear routing signals like 'for credential management and connection security practices' or similar",
      "max_score": 10
    },
    {
      "name": "LEGACY_EXAMPLES.md recommendation",
      "description": "Recommends REMOVING LEGACY_EXAMPLES.md - it's deprecated content from v1.x that shouldn't be in the bundle anymore",
      "max_score": 10
    },
    {
      "name": "DRAFT_REPLICATION.md recommendation",
      "description": "Recommends REMOVING DRAFT_REPLICATION.md - it's unfinished/unimplemented content that shouldn't be in a published tile",
      "max_score": 10
    },
    {
      "name": "Bloat reduction framing",
      "description": "Frames orphaned files as adding bloat to the tile - mentions tile size, unnecessary files, or reducing bundle size",
      "max_score": 5
    },
    {
      "name": "Clear routing signals emphasis",
      "description": "When recommending links, emphasizes the need for clear routing signals (WHEN to open each file) rather than generic 'see FILE.md for more info' links",
      "max_score": 5
    },
    {
      "name": "Link vs remove justification",
      "description": "Provides clear reasoning for why some orphaned files should be linked (valuable content) vs removed (deprecated, unfinished, or no longer relevant)",
      "max_score": 5
    }
  ]
}

Install with Tessl CLI

npx tessl i tessl-labs/skill-optimizer

evals

tile.json