clean-up
Skill35 starsChanged 43 days agoApache-2.0View on GitHub
Deliver a finished optimization run as a branch the user can merge. Cherry-pick the commits that changed the workload onto the base, hardcode the A/B flags, re-verify on the shipped code, strip the checkpoint calls in a last commit, and leave the user standing on that branch with a handover.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- snappedly/skillstheir own version, first seen Oct 13, 2026
- robertbradley-oss/skillstheir own version, first seen Sep 12, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- robertbradley-oss/skills★ 2same name
- snappedly/skills★ 2same 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 repository8 other files it gives its agents.
- convert-to-benchmark-scriptSkill
- diagnoseSkill
- extract-computation-graphSkill
- initSkill
- optimizeSkill
- publish-prSkill
- setup-baselineSkill
- torch-profileSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 43
Write the full handover in latest-report.md for the reader named in contract.md.
- Distinctive: line 68
Keep detailed measurements, rejected candidates, and routine debugging history in the report.
- Distinctive: line 71
Stop at the branch. What happens to it next is the user's to decide.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Deliver the branch
The campaign branch is a record, not something to merge.
- Tag it, then cherry-pick the survivors onto the base it ran on.
git tag <campaign>-full-history HEAD. Never rewrite the campaign branch:records/candidates.jsonlreferences its shas, and every check below compares against it. - Cherry-pick, do not rebase and drop. A rejected candidate and its revert cancel out in the net diff, but a replay still applies each one.
- Ship only what changed the workload, plus the checkpoint calls, which step 6 removes again. Runners and capture harnesses stay behind, and their commands go into the reproduce block instead. Anything in the shipped source that imports a file outside the checkout is a harness, whatever it is called.
- Delete the A/B flags before you measure, not on both sides of the
deletion, and as one commit of its own. Watch for an
elsethat is another caller's entry point, and theimport osonly the flag needed. - Run the recorder comparison here, on the head with the flags hardcoded
and the checkpoint calls still in, against the setup tolerance. This is the
code that ships plus the calls that record it, so name it:
git branch <delivery>-verify HEAD. A maintainer who wants to reproduce the correctness table checks that branch out. - Strip the checkpoint calls in one last commit. Pure deletion, nothing else in it: the recorder's import, its calls and any file that exists only for them. Maintainers review the speed-up, not the instrumentation, so the delivery branch carries none. If the repo's own recorder was used, there is nothing to strip and no verify branch; say so in the handover.
- Time what ships. An interleaved timed pair on this head, with
git checkout <base> -- <src dirs>for the before arm. If something goes wrong, fix it, and redo step 5 if the fix touched the model's math.
Rename the branch to what you want merged and leave it checked out.
Move stray files out of the workspace root and update any affected paths or commands.
Handover report
Write the full handover in latest-report.md for the reader named in
contract.md. Put yourself in their position and explain the results in terms
they can understand. Include:
- the branch, its base, and that merging is theirs
- the verify branch: the delivery branch before its last commit, so the same code with the checkpoint calls, and the command that compares a run of it against the baseline record
- where the time went before, pointing at the baseline's diagnosis under
commits/<base sha>/report.md, and which of its findings each shipped technique removed - the speedup in the unit they plan in, with the GPU model and count
- a table of techniques and their numbers, from
benchmark.csv - how to reproduce it without the scaffolding
- the correctness evidence
Point at records/candidates.jsonl and the tag for what was rejected, rather than
transcribing it.
Final message to the user
Give the user a short summary of the outcome, the main changes, and whether
the agreed checks passed. Highlight any unresolved issue or decision they
need to make, and link to the delivery branch and latest-report.md.
Keep detailed measurements, rejected candidates, and routine debugging history in the report; do not repeat the full handover in this message.
Stop at the branch. What happens to it next is the user's to decide.
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.

