One-click install
npx skills add https://github.com/mthli/skills --skill review-iterate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-iterate
Source: https://github.com/mthli/skills/tree/main/review-iterate
Command: npx skills add https://github.com/mthli/skills --skill review-iterate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents review sessions from turning into padding by enforcing a structured, multi-round workflow where the user selects what to fix and Claude only proceeds with those items.

Core Features & Use Cases

  • Severity-grouped findings per round: Claude lists new issues grouped by 🔴/🟠/🟡/🟢 so you can prioritize what matters most for correctness and quality.
  • User-driven fix selection: you explicitly choose which findings to fix, and Claude fixes only the selected ones.
  • Diminishing-returns stopping rule: the skill recommends wrapping up when findings degrade to polish-only or when consecutive rounds produce very little new value.
  • Use case: after implementing changes to a file, run another verification pass to catch regressions or newly visible issues without endlessly generating extra nitpicks.

Quick Start

After you finish a change burst, ask the AI to review the updated scope using review-iterate.

Frequently Asked Questions about review-iterate

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

FAQPage Schema
How do I run multiple passes of code review without generating endless nitpicks?

Iterative code review enforces a structured, multi-round workflow where findings are tiered by severity and a stopping rule triggers when only minor polish items remain. This prevents review sessions from turning into unproductive padding by requiring explicit user selection before applying any fixes.

What is severity-tiered issue listing for iterative refinement?

Severity-tiered issue listing groups review findings into red, orange, yellow, and green categories so you can prioritize what matters most for correctness. You explicitly choose which tiered findings to address, and the system fixes only those selected items before re-reviewing the updated scope.

How do I catch regressions after a burst of code or documentation changes?

Run a verification pass after implementing changes to catch regressions or newly visible issues. The process requires a fresh re-review of the updated scope that avoids recycling previous findings, ensuring that new problems are detected without endlessly generating extra nitpicks.

Can I prioritize user-selected fixes instead of applying all review findings at once?

Yes, user-driven fix selection is the core mechanism. The system lists issues grouped by severity, provides an explicit recommendation, and then defers to your selection. It applies a fix-only-next-step behavior, ensuring only your chosen items are remediated in the subsequent step.

When should I stop iterating on documentation or code review?

You should stop iterating when a diminishing-returns threshold is met. The process recommends wrapping up when findings degrade to green polish-only items or when consecutive review rounds produce very little new value, preventing unnecessary repetition.

Is this multi-round review approach suitable for one-shot fixes or security audits?

No, this approach applies specifically to non-security and non-one-shot contexts. It is designed for work-in-progress code or documentation requiring multi-round, user-prioritized verification and iterative refinement rather than immediate or security-focused remediation.