simonepri/ifttt-lint / .agents/skills/polish
polish
VerifiedIteratively review and fix issues on the current branch until the review passes.
Polish
Review-fix loop on the current branch until it converges to LGTM. Require 3 consecutive LGTMs before declaring convergence (reviews are non-deterministic, especially for large changes). Maximum 25 iterations.
Preflight
Check git log main..HEAD --oneline. If no commits ahead and no uncommitted changes, ask the user what they intended. Stage and commit any uncommitted changes before starting.
Count the commits ahead of main. This determines how fixes are committed in the loop:
- Single commit: use
/amendto fold fixes into it each iteration. - Multiple commits: create a single
polish: ...commit on the first fix iteration, then/amendthat same commit on subsequent iterations. This keeps all polish fixes in one commit rather than scattering them across iterations.
State tracking
Track across iterations: Fixed (what was changed), Dismissed (why not fixed), Pending user input (needs a decision). When a re-raised issue was previously dismissed, skip it.
Loop
- Review: delegate to a fresh sub-agent with no prior context (so it reviews the code on its own merits, not anchored to previous findings): "Run
/reviewon the current branch against main. Skip: PR description, Needs verification, Existing issues." - Triage: for each finding — skip if dismissed, fix or dismiss with rationale, collect ambiguous cases for user input. Watch for findings that reveal design gaps (wrong assumptions, flawed mental models) regardless of severity — escalate these to the user rather than auto-fixing, as they may require rethinking the approach.
- Fix: apply fixes (🔴 > 🟠 > 🟡), run lint/format, then commit using the strategy determined in Preflight (amend for single-commit branches, new commit for multi-commit branches). Go to Step 1.
- Report:
✅ LGTM after N iterationsor⚠️ Stopped after N iterations. List fixes by file, dismissed items, and remaining issues.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |