skill-improver

Optimizes agent skills by running evals, mutating prompts, and keeping only validated gains.

4|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/exiao/meta-skills --skill skill-improver-exiao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/exiao/meta-skills/tree/main/skill-improver
Command: npx skills add https://github.com/exiao/meta-skills --skill skill-improver-exiao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Most agent skills work about 70% of the time and silently fail the rest. This Skill replaces guesswork rewriting with a measured optimization loop: it runs a skill against binary evals, diagnoses failures from full execution traces, applies structured edits, and keeps only changes that pass a statistical acceptance gate. ## Core Features & Use Cases - Eval-driven hill climbing: Splits 8-12 test inputs into train/validation/test sets, scores every mutation with binary pass/fail evals, and gates keep/discard decisions through a PACE statistical acceptance script. - Trace-based failure diagnosis: A separate optimizer model reads verbatim per-run execution traces, cites the exact divergence step, and proposes typed structured edits (append, insert_after, replace, delete) or Pareto-frontier merges. - Full audit trail: Produces a live HTML dashboard, results.tsv log, changelog of every mutation, rejected-edit buffer, and checkpoint files for resumable runs, while never modifying the original SKILL.md. - Use Case: A prompt skill that generates ad creative scores 43% on your evals. Run this Skill to iterate autonomously through structured mutations until validation scores reach 95%, then receive the improved copy plus an honest held-out test delta. ## Quick Start Ask the agent to optimize your skill by running it against binary evals and keeping only validated improvements, providing the skill path, test inputs, and eval criteria.

Frequently Asked Questions about skill-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize an AI agent skill with evals?▼

Define 8-12 test inputs and 3-6 binary pass/fail eval criteria, then run the loop: establish a baseline score, propose structured edits from failure traces, and keep changes only when the PACE validation gate confirms a statistically real gain.

What makes a good binary eval for prompt optimization?▼

A good eval is a yes/no question two different scorers would answer identically, such as checking for banned phrases or required sections. Avoid 1-10 scales, which compound variance, and avoid checks so narrow the skill games them.

Should the optimizer model be the same as the target model?▼

No, the default uses a different architecture for the optimizer than the target so it can catch systematic blind spots the target cannot see in itself. A same-model config is available for quick or cost-sensitive runs.

Does skill-improver modify my original SKILL.md file?▼

No, it never edits the original SKILL.md. All mutations happen on a working copy in an autoresearch directory, and the improved version is delivered separately for the user to adopt.

Why did my optimization run overfit the validation set?▼

Validation scores can drift upward over many experiments because the gate sees them repeatedly. The held-out test set, scored once at the end, reveals the honest improvement; a large val-test gap indicates overfitting.

How many test inputs do I need for prompt hill climbing?▼

8-12 inputs support a clean 50/25/25 train/validation/test split, and the PACE gate needs at least 8 paired validation instances to auto-commit. With 4 or fewer inputs no split is possible and overfitting risk is high.