Optimize Skill
Eval-gated loop to improve a skill's SKILL.md without regressions
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-skillEval-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.