Optimize Skill

Eval-gated loop to improve a skill's SKILL.md without regressions

Tested · Didn't pass

Test report

Verdict
Tested · Didn't pass
Tested
Jul 15, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 33d60cf

Copying just the skill folder (the only GitHub-only install path available) leaves scripts/optimize.sh unresolved — verified with a real install: `bash scripts/optimize.sh score ...` from inside the copied skill dir exits 127, 'No such file or directory', because the actual script lives one level up at skill-maxing-plugin/scripts/, not inside optimize-skill/.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 3/5
  • Triggers reliably 5/5
  • Output vs. baseline 4/10
  • Docs & honesty 4/5

What Optimize Skill does

Runs a rollout-score-reflect-apply-validate-promote loop against an existing skill's eval.yaml, capping edits per step and blocking promotion unless a candidate strictly beats the current version with no held-out regression. Triggers when a skill underperforms or the user asks to optimize/tune/improve a skill that already has an eval set.

How to install Optimize Skill

git clone https://github.com/Bennyoooo/skillmaxxing
cd skillmaxxing
mkdir -p ~/.claude/skills
cp -r skill-maxing-plugin/skills/optimize-skill ~/.claude/skills/optimize-skill

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Optimize Skill

  • /optimize-skill Eval-gated loop to improve a skill's SKILL.md without regressions

It also activates on plain-language prompts like these:

  • My PR-review skill has an eval.yaml but keeps failing one test case
  • Optimize this skill's prompt against its eval set without breaking passing cases
  • This skill scores badly on its evals, improve it without regressing the rest

Frequently asked questions

Is the Optimize Skill skill free?
Yes. The skill itself is free from Bennyoooo/skillmaxxing. SkillProof publishes the install command and an independent test verdict at no cost.
Does Optimize Skill work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 15, 2026. Verdict: Tested · Didn't pass. Copying just the skill folder (the only GitHub-only install path available) leaves scripts/optimize.sh unresolved — verified with a real install: `bash scripts/optimize.sh score ...` from inside the copied skill dir exits 127, 'No such file or directory', because the actual script lives one level up at skill-maxing-plugin/scripts/, not inside optimize-skill/.
How do I install Optimize Skill?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Optimize Skill with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.