sweep
Installation
SKILL.md
Sweep
Each cycle finds the highest-value issue you can prove, fixes its root cause, verifies the fix, and opens one PR against the default branch. One cycle, one issue, one PR.
Invoking this skill authorizes, per cycle: a branch and worktree, commits, pushing that branch, and opening and labeling its PR. It does not authorize merging, deploying, any production write, pushing to the default or a deploy branch, or deleting a pushed branch.
Every run finds something new
The skill runs again and again on the same repo. Its PRs from earlier runs stay open for days.
- Earlier work removes candidates. It never ends the run. An open PR, a kept
sweep/*branch, a leftover worktree, or a dirty main checkout is not a reason to stop or to reuse anything. Drop the candidates that earlier work covers, and keep looking. - Widen before you give up. When the top candidates are all covered, go down the priority list and into code that no recent PR touched. Look again at production signals over a longer time range.
- Never invent. Pressure to find something new never lowers the evidence bar in Prove one issue. Do not reword a covered issue, split one fix into two PRs, or promote a style preference or a hypothetical risk. A run that searched widely and found nothing provable ends with no PR and a report of what it examined. That is a correct result.
Arguments
Parse these before any discovery. On invalid input, stop and report it.