CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/skill-optimizer

Optimize your skills and tiles: review SKILL.md quality, generate eval scenarios, run evals, compare across models, diagnose gaps, and re-run until scores improve.

88

1.07x
Quality

94%

Does it follow best practices?

Impact

88%

1.07x

Average score across 24 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

phase1-gather-context.mdskills/setup-skill-performance/references/

Phase 1: Find the Tile

1.1 Find the tile

Look for a tile.json in the current directory or a parent/sibling directory. Exclude .tessl/ cache directories:

find . -name "tile.json" -not -path "*/node_modules/*" -not -path "*/.tessl/*" 2>/dev/null | head -10

If the user provides a path inside a .tessl/tiles/ directory (an installed tile cache), stop and warn them: that path is Tessl's local install cache — running evals from there won't work and changes would be overwritten on the next tessl install. Offer two options: point to the original tile source, or copy the tile out of .tessl/tiles/ to a new location (cp -r .tessl/tiles/<workspace>/<tile> ./<tile>).

If multiple tiles are found outside .tessl/, ask the user which one to evaluate. If none are found, explain that this skill evaluates a packaged tile and suggest tessl tile new to get started.

1.2 Verify login

tessl whoami

If not logged in, ask the user to run tessl login before continuing.

1.3 Check for existing scenarios

Check if scenarios already exist in the tile's evals/ directory:

ls <tile-dir>/evals/*/task.md 2>/dev/null

If scenarios exist, warn the user:

"You already have scenarios in evals/. Options:

  1. Add more — generate new scenarios alongside existing ones
  2. Replace all — generate new scenarios and replace existing ones
  3. Skip generation — just run evals on existing scenarios

What would you prefer?"

skills

README.md

tile.json