hill-climb
Skill4 starsChanged 5 days agoMITView on GitHub
Optimize a defined outcome through bounded evaluation loops. Use for hill-climb requests or repeated improvement against an executable eval, benchmark, or visual comparison; not a one-pass review.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- niksavis/handilytheir own version, first seen Nov 16, 2026
- lennoxsaint/Skillstheir own version, first seen Nov 15, 2026
- richard-better/skillstheir own version, first seen Nov 15, 2026
- Enjoyoer/loadouttheir own version, first seen Nov 8, 2026
- salalaslam/skillstheir own version, first seen Nov 8, 2026
- skillberry-ai/cap-evolvetheir own version, first seen Nov 8, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- Bil0000/Hill-Climb★ 137same name
- skillberry-ai/cap-evolve★ 70same name
- lennoxsaint/Skills★ 48same name
- niksavis/basicly★ 2same name
- niksavis/handily★ 2same name
- jpoindexter/ai-agent-skills★ 1same name
- richard-better/skills★ 1same name
- Enjoyoer/loadout★ 0same name
- salalaslam/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository119 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- accessibilitySkill
- agent-watchdogSkill
- aipSkill
- animateSkill
- animation-performanceSkill
- animation-vocabularySkill
- ask-benSkill
- ask-sonnerSkill
- bazelSkill
- bend-lawsSkill
- blast-radiusSkill
- brain-dumpSkill
- break-uiSkill
- ci-fixesSkill
- codebase-designSkill
- codex-compatSkill
- codexSkill
- commit-push-prSkill
- connect-querySkill
- create-verification-skillSkill
- demoSkill
- development-lifecycleSkill
- diagnosing-bugsSkill
- docsSkill
- dogfoodSkill
- domain-modelingSkill
- e2e-testingSkill
- effect-tsSkill
- effect-v3-to-v4Skill
- efficient-frontierSkill
- eli5Skill
- excalidraw-diagramSkill
- extend-harnessSkill
- frontend-invariantsSkill
- frontend-starter-kitSkill
- full-sendSkill
- gesturesSkill
- golang-reviewSkill
- golangSkill
- goSkill
- grillingSkill
- handoffSkill
- hook-auditSkill
- implement-specSkill
- improve-animationsSkill
- improve-codebase-architectureSkill
- improveSkill
- launchdarklySkill
- learn-tasteSkill
- lie-detectorSkill
- maintain-verification-skillSkill
- make-pr-easy-to-reviewSkill
- mobile-nativeSkill
- plan-arbiterSkill
- plow-aheadSkill
- postgresqlSkill
- primeSkill
- productSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 8 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 9 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
Use the existing task contract or a compact inline note:
- Distinctive: line 31
If no credible evaluator exists, build the smallest authorized verifier or report the missing prerequisite.
- Distinctive: line 32
If the baseline already meets the outcome, confirm it and stop without speculative edits.
- Distinctive: line 48
Only when review policy permits staging, screen with an authorized judge before the full panel.
- Distinctive: line 61
Evaluate: run relevant checks and the frozen evaluator on the exact candidate.
- Distinctive: line 67
Record: keep a compact ledger: candidate, hypothesis, evidence/delta, guardrails, keep/revert, remaining budget and unresolved findings.
- Distinctive: line 71
Stop at confirmed acceptance, exhausted budget, two consecutive no-gain candidates, or an external/reserved blocker.
- Distinctive: line 81
Keep the original scope and target.
“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Optimize the artifact, not its judge. Prefer executable evidence; calibrate visual judgment.
Compose with existing owners
Load only applicable owners; share one loop and budget:
- Development lifecycle owns implementation/delivery; improve stays advisory. Report/plan/review requests authorize no implementation edits.
- Quantify impact owns metrics, worthwhile deltas and noise.
- For UI, visual review owns rendered evidence/specialist routing; dogfood owns behavior/recovery checks.
- Explicitly authorized council or sol-loop supplies read-only rounds under host compatibility. Otherwise review inline, never as independent. No implicit delegation; efficient frontier owns routing/capacity. Helpers share the budget.
Define the hill before editing
Use the existing task contract or a compact inline note:
- Objective: beneficiary, outcome, primary metric or rubric categories, acceptance condition and minimum worthwhile improvement.
- Guardrails: protected behavior, accessibility, security, edit surface and resource limits; preserve unrelated work and the user's endpoint.
- Verification: evaluator command/visual protocol, fixture, environment, original revision and best confirmed candidate (the incumbent). Retain both references.
- Stop: endpoint, finite evaluation/resource budget and plateau rule. Default: three candidate attempts, accepted or not; one intervention counts once regardless of file count. Baseline batches, retries and confirmation all consume the evaluation/resource budget. Reserve confirmation capacity before each attempt; stop searching if it cannot fit. Tighter user, reviewer or host limits win; re-baselining never resets counters.
If no credible evaluator exists, build the smallest authorized verifier or report the missing prerequisite; an easy proxy is not the requested result. If the baseline already meets the outcome, confirm it and stop without speculative edits.
Calibrate the evaluator
Choose the applicable branch; keep its inputs fixed throughout comparable rounds:
| Branch | Baseline and proof |
| Executable correctness/eval | Reproduce representative failures and retain valid controls. Freeze assertions, expected answers and supported routes; keep held-out cases for confirmation when feasible. |
| Performance/resources | Use the optimization experiment protocol: identical workload/environment, paired measurements, noise and fidelity guardrails against original and incumbent. |
| Visual quality | Follow visual calibration. Capture original, candidate and requested reference products in comparable states; preserve design intent, behavioral and accessibility gates. |
For authorized independent visual reviews, use fresh contexts with the same artifacts, rubric, intent, constraints, check results and unresolved findings. Withhold desired ratings, previous scores and preferred winners; use neutral candidate labels where practical. Request evidence-backed comparisons and specific defects. Numeric ratings are requested-only and advisory. Inline self-review is neither blind nor independent.
Only when review policy permits staging, screen with an authorized judge before the full panel. Reserve capacity for every required final reviewer on the same candidate. Mark not-run, unavailable or stale results explicitly, never as agreement; staging grants no provider substitution or weaker final coverage.
Re-evaluate an unchanged reference to detect judge drift. If unchanged inputs receive materially different judgments, investigate or report uncertainty instead of claiming a win. An evaluator repair or changed rubric, fixture, model or environment needs a fresh baseline; never splice incompatible scores into one trend or weaken tests to pass. Calibrate an added or replacement authorized judge on the unchanged references; keep per-judge results separate.
Climb
- Hypothesize: choose one evidenced bottleneck/quality defect; predict a small reversible improvement without breaking a guardrail.
- Change: implement only that intervention through its owner. Preserve a recoverable incumbent; freeze scoped inputs during review.
- Evaluate: run relevant checks and the frozen evaluator on the exact candidate. Reuse valid evidence; record invalid samples, failures and unavailable coverage honestly.
- Confirm, then keep: require a worthwhile gain beyond noise and intact guardrails against original and incumbent. Keep it provisional until a fresh fixed batch confirms it; advance the incumbent only then. Failed/inconclusive confirmation rejects the trial; restore only its owned edits, retaining the confirmed incumbent and others' work. Ties or missing results are not gains.
- Record: keep a compact ledger: candidate, hypothesis, evidence/delta, guardrails, keep/revert, remaining budget and unresolved findings. Use ignored/temporary storage only when the run needs it; no routine audit dumps or per-round PRs.
Stop at confirmed acceptance, exhausted budget, two consecutive no-gain candidates, or an external/reserved blocker. An owner-raised target needs a new explicit contract; preserve the prior result and budget record rather than silently escalating or creating another PR/worktree.
| Exit evidence | Report |
| Current confirmation meets target and every guardrail | met; retain confirmed incumbent. |
| Valid evaluations fall short at budget/plateau stop | unmet; retain best confirmed incumbent, not the last trial. |
| Missing/invalid evaluator, drift or unavailable required coverage | unverified; retain incumbent and name the missing proof. |
A higher rating never resolves a substantive defect. Apply requested per-category and reference-ranking targets individually; an overall average cannot hide a missed target. Keep the original scope and target; diagnose invalid evaluations rather than rerolling unchanged candidates for a passing grade.
For prompt/tool-description optimization, load the experiment protocol. Establish correctness before compression; preserve its supported matrix and regression suite.
Confirm and hand off
Reuse confirmation only for unchanged inputs; re-run invalidated functional/visual checks against the original. Disclose missing independent coverage; consensus or ratings cannot replace verification or human approval.
Report outcome/target status, original-to-final evidence, kept/reverted experiments, remaining limits and why the loop stopped. Continue through the existing delivery owner to the user's endpoint; hill-climb itself adds no PR, merge, deployment or monitoring grant.
Examples:
/hill-climb improve sidebar readability against the supplied screenshots; preserve keyboard flows; 3 candidates; local only; no delegates/hill-climb reduce tool-description tokens while preserving the existing tool-choice eval across supported routes; 3 candidates; local only; no delegates
Source: Theo's walkthrough, 06:18-08:09 (review loop), 11:39-20:44 (visual comparison, staged reviews, score drift), 26:37-30:27 (failure-derived evals, correctness before compression). Budgets and permission boundaries are harness adaptations.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

