sklab optimize#

LLM-powered SKILL.md rewrite with diff preview and score delta.

Also available over HTTP. The Optimize Skill endpoint runs the same logic on the server against a GitHub repository — useful when you want results in a browser, a CI job without installing Python, or an agent that reaches skill-lab.dev directly.

Usage#

bash
sklab optimize [SKILL_PATH] [OPTIONS]

Reads the latest evaluation from .sklab/evals/ (so run `sklab evaluate` first), feeds the static failures and judge feedback to an LLM, and proposes an improved SKILL.md. Shows a unified diff and a before/after score before applying. Pass --auto to skip the confirmation prompt.

Arguments#

ArgumentRequiredDescription
SKILL_PATHnoPath to the skill directory. Defaults to the current directory.

Options#

FlagValueDescription
--model, -m<MODEL_ID>
default: claude-haiku-4-5-20251001
Model ID. Supports Anthropic, OpenAI (gpt-*), and Gemini (gemini-*) models.
--autoflagApply the rewrite without the confirmation prompt.

Examples#

Review diff interactively

bash
$ sklab optimize ./my-skill

Apply without prompt

bash
$ sklab optimize ./my-skill --auto

Use a stronger model

bash
$ sklab optimize ./my-skill -m claude-sonnet-4-6

Notes#

  • Requires a prior `sklab evaluate` run — optimize reads from .sklab/evals/.
  • Requires ANTHROPIC_API_KEY, OPENAI_API_KEY, or GEMINI_API_KEY for the selected provider.