review-loop
Skill2 starsChanged 9 days agoMITView on GitHub
Use when the user requests an iterative implementation, independent review and repair loop, or invokes review-loop to carry a goal to an agreed endpoint.
54 other projects use a version of this.
Adopted by
Most recently taken up by
- revisit-studies/studytheir own version, first seen Nov 9, 2026
- Mmbugraaslan/motion-plustheir own version, first seen Nov 8, 2026
- zane-tv/holdframetheir own version, first seen Nov 8, 2026
- BK202503/open-claude-alltheir own version, first seen Nov 8, 2026
- Latand/delegatustheir own version, first seen Nov 8, 2026
- blockscout/frontendtheir own version, first seen Nov 1, 2026
Used with
Projects with it also use motion-design, polish and 8 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
soilmassSkillmotion-design
Create animations and motion graphics using industry standards. Use when asked to animate UI elements, create video content, implement transitions, or build motion systems. Implements W3C Design Tokens, Material Design 3 baseline, and Lottie specification compliance.
Also in 5 projects that use this
HK-hubSkillpolish
Performs a final quality pass fixing alignment, spacing, consistency, and micro-detail issues before shipping. Use when the user mentions polish, finishing touches, pre-launch review, something looks off, or wants to go from good to great.
Also in 3 projects that use this
GoogleSkillto-spec
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
Also in 4 projects that use this
GoogleSkillimprove-codebase-architecture
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Also in 5 projects that use this
MicrosoftSkillcouncil
Convene the persona panel — six orthogonal review lenses — on a target. Cold independent fan-out, debate-to-consensus, synthesized verdict with recorded dissent and a roster manifest.
Also in 3 projects that use this
NVIDIASkillresearch
Before designing a feature, research how comparable libraries solve the problem, check best practices, known pitfalls, and upstream changes. Use when starting a new feature, investigating an unfamiliar area, or the user asks to research something.
Also in 5 projects that use this
- +4 more from google
Other versions54 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 54
- didi/mpx★ 4ksame name
- blockscout/frontend★ 310same name
- microsoft/bocpy★ 184same name
- 9thLevelSoftware/legion★ 76same name
- microsoft/Trieste★ 53same name
- revisit-studies/study★ 46same name
- timharris707/skills★ 44same name
- Latand/delegatus★ 37same name
- spxrogers/agentsync★ 35same name
- mathruffian-dot/claude-motion-explainer★ 30same name
44 more not listed
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 repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agent-tuneupSkill
- babysitterSkill
- challengeSkill
- choose-designSkill
- design-loopSkill
- focus-groupSkill
- github-writingSkill
- implementSkill
- raise-issueSkill
- raise-prSkill
- reviewSkill
- shipSkill
- test-writerSkill
- thinkSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 11 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 47 edited versions we read keep these.
11
Distinctive
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
- Distinctive: line 23
Stop successfully when the target and required acceptance gates are met, or stop incomplete after two consecutive rounds without improving …
- Distinctive: line 25
No round cap, deadline or spend ceiling is required.
- Distinctive: line 27
Test target and required gates before stagnation.
- Distinctive: line 31
When additional judges score a round, use the lowest score on the same frozen candidate.
- Distinctive: line 54
Keep the rubric and target fixed.
- Distinctive: line 55
Follow review's dispatch rules for every round.
- Distinctive: line 65
Run covering checks before review and report missing or pre-failing checks.
- Distinctive: line 79
Do not edit scoped files while evaluation runs.
- Distinctive: line 83
Verify each finding using severity, location, reproduction or supporting evidence, and impact, and apply review's release treatment for its …
- Distinctive: line 124
Verify the deployed revision and actual behavior on each requested target.
- Very specific: line 133
Keep updates brief: result, material findings and next action.
- Distinctive: line 146
Use authorized native orchestration, without another scheduler or top-level thread substitute.
“Common” is measured: kept by at least 6 in 10 of the 47 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
Implement, review, repair
Triggers
Infer the goal and endpoint from the request; ordinary engineering work does not automatically need this loop.
Workflow
- Inspect the request, repository rules, working tree and existing progress. Establish scope, observable acceptance criteria and the authorized endpoint, which may be a verified local change. Ask only about material unresolved choices. Preserve explicit user limits. Fix the scoring rubric, precision and target before implementation; reuse supplied criteria and ask only if the target cannot be inferred. Seed the best score with a baseline evaluation. Hill-climb from the best candidate: only a strict increase replaces the best and resets the consecutive non-improvement counter. A tie or regression increments it. Stop successfully when the target and required acceptance gates are met, or stop incomplete after two consecutive rounds without improving the best score. No round cap, deadline or spend ceiling is required. Honour explicit user limits. Preserve scores and counters across repairs, reviewers and resumes. Test target and required gates before stagnation. Baseline seeds the best with counter zero; later completed evaluations count once each. Retain the earlier best on ties. Preserve required bug fixes when selecting the repair base or final candidate; a higher historical score cannot justify dropping them. When additional judges score a round, use the lowest score on the same frozen candidate. Record any metric change explicitly; retain prior progress history.
- Apply review for cross-lineage eligibility, reviewer selection and dispatch. Every loop participant reads and applies that skill for its assigned role: the coordinator obtains review and owns feedback dispositions, implementers repair selected findings, and evaluators return evidence without further delegation. Follow review's rule for named reviewers and conflicts.
- For UI work likely to end in a PR, apply raise-pr early to capture practical mobile and desktop before screenshots. Implement directly unless substantial independent work warrants delegation; make small review repairs directly when authorized. Keep concise notes in a verified ignored task directory: goal, authority, scope, milestones, base/head, exact models and options, scores, best candidate, non-improvement counter, explicit limits, task handles, stable finding IDs, dispositions, checks and next action. Use one cross-lineage evaluator per round. Add another opinion only for a concrete unresolved risk or disagreement. Additional judges may share a lineage under review's higher-reasoning exception. Apply review's selection policy; report unavailable choices. Inside implement, that policy remains cost-aware across all rounds and additional opinions. Routine rechecks can use the original reviewer's lineage while it remains eligible under review, including after repairs by new authors. Keep the rubric and target fixed; agreement alone is not acceptance. Follow review's dispatch rules for every round. All loop briefs include review's path and require the participant to read and apply it in its assigned role, including implementation participants and assigned reviewers. Schedule independent preparation and covering checks concurrently where their resources do not interfere. Dispatch multiple selected evaluators together once their prerequisites are met. While review runs, organize evidence, prepare the handoff and investigate existing failures read-only; draft repair options as notes. Keep source, build, runtime and test data frozen for all evaluators. Use isolation for conflicting checks or defer them. Wait only when remaining work depends on results, following host continuation rules.
- Run covering checks before review and report missing or pre-failing checks.
Establish the merge-base and owned paths, including untracked source, for the
review phase. Round one uses a fresh read-only evaluator on the full scoped
diff, surrounding callers and every acceptance criterion. Supply intent,
exclusions, version, checks, rubric and target; require a score with evidence.
Ask for consequential
bugs, broken callers and unnecessary code, tests, guards or procedure.
Apply review and include it in the
review brief. Require key-state screenshots for visible behavior and every
visible finding; the reviewer reports bugs and SEV1–SEV3 severity to the parent,
which owns repair, deferral and issue-filing decisions within its authority.
Require a complete plain-text final report with stable finding IDs, severity,
file:line, evidence and impact. Delegates must not use
html_render; findings must reach the coordinator, not only a child-thread presentation. Do not edit scoped files while evaluation runs. A timeout, error, missing reply or task completion status is not approval. Cancel failed work and verify it stopped before one diagnosed retry. Missing evaluations have no score and do not advance the score counter; stop incomplete if recovery fails. - Verify each finding using severity, location, reproduction or supporting evidence, and impact, and apply review's release treatment for its SEV level. Repair findings selected by the parent and unmet criteria within scope. Capture fresh evidence for visible fixes and preserve original findings. Prefer deleting or narrowing when it fixes the cause. Challenge incorrect or unnecessary requests with evidence rather than appeasing the reviewer. Preserve original finding IDs and append fixed, rejected or deferred evidence. Track diff growth as a prompt to examine scope, not a line-count target.
- Later rounds use fresh read-only evaluation tasks focused on changed behavior and unresolved findings. Supply the full scoped diff, the delta since the last review, checks and finding ledger. Broaden review when a change affects shared assumptions, interfaces or previously reviewed behavior. Keep the phase's base and scope explicit; if either changes, record why and reassess affected evidence. Re-review material behavior changes, unresolved consequential findings or gaps in acceptance coverage. Editorial corrections and declined nits need no new round. Never transfer approval across unreviewed behavior or shop for reviewers.
- Accept when the score meets target, evidence covers current behavior, criteria are met and remaining findings have explicit dispositions consistent with review's release treatment. An approved exception does not mean the bug is fixed. Incomplete visual review remains an evidence gap in the release recommendation. Reviewer verdicts inform that decision; agreement alone does not prove it. The parent decides deferrals and retains severity and supporting evidence. Apply review's deferred-bug tracking rule: hand off verified issue URLs or owned asynchronous filing requests for already non-blocking bugs. Filing remains within authority and tracking stays incomplete until URLs are verified. On stagnation, explicit limits or extension requests, apply progress diagnosis and report the unmet target and remaining gates. Stagnation is not approval. Escalate only material decisions the user must make. Continue independent authorized work while dependent work is blocked.
- Complete the agreed endpoint with its required evidence. For PR creation or updates, apply raise-pr for templates, screenshots, agent attribution and independent review. A source fix does not complete a requested merge or deployment. Bundle local review repairs before pushing when practical; an authorized branch push or existing-PR update may happen earlier when hosted checks or previews are needed for proof. New PR creation still requires completed independent review under raise-pr. If proof requires creating a PR before review, report that dependency and seek an explicit user waiver rather than infer one. Refresh current-head checks/reviews before merging. Verify the deployed revision and actual behavior on each requested target. At a blocker, stagnation stop or explicit limit, report what remains incomplete.
On resume, reconcile existing tasks and preserve decisions, findings and remaining scores, best candidate, counters and explicit limits. On cancellation, stop only owned work and confirm it stopped.
Outputs
Keep updates brief: result, material findings and next action. Final handoff includes
revision, implementation attempts, rounds used, target/best/current scores,
non-improvement counter, explicit limits, exact work and
review models, checks, finding dispositions, deferrals and endpoint evidence or
remaining blockers. Report usage only when exposed. Separate local validation,
hosted checks, independent review, merge and deployment. Delegated coordinators
return complete plain-text reports; only the main thread presents them. In T3
Code, the main-thread coordinator uses html_preview then html_render for
user-facing substantive findings and disposition reports;
use readable text when native HTML is unavailable or the result is brief.
Boundaries
Use authorized native orchestration, without another scheduler or top-level thread substitute. Follow host model, sharing and permission rules. Preserve unrelated work and repository protections. Reuse existing authority; this skill grants no extra permission to publish, message others, spend, merge or deploy.
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.

