review
Skill1 starsChanged 3 months agoMITView on GitHub
Independently review code, interfaces, writing, data, architecture, repository agent-operability, or another agent’s work against the real contract and artifact. Default to read-only; repair only when explicitly requested.
192 other projects use a version of this.
Adopted by
Most recently taken up by
- microsoft/veronatheir own version, first seen Nov 8, 2026
- microsoft/FluidFrameworktheir own version, first seen Nov 8, 2026
- charliee1w/consolidation-memorytheir own version, first seen Nov 8, 2026
- jisuzzzz/haechitheir own version, first seen Nov 8, 2026
- apokamo/kajitheir own version, first seen Nov 8, 2026
- dirien/yet-another-agent-harnesstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use close-spec, design-with-images and 10 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.
dzhngSkillclose-spec
When a spec under specs/<feature>/ is done shipping (a write-spec build, or any planned task that produced a spec), archive it to specs/done/ and rewrite it from a build-plan into a durable rationale — the why, the principles, the invariants — pointing back to the real code for the how. Use when implementation has landed and the plan no longer matches what shipped, or the user says a feature/spec is finished. Pairs with [write-spec](../write-spec/SKILL.md) (the plan this closes) and [review](../review/SKILL.md) (run before closing).
Also in 5 projects that use this
dzhngSkilldesign-with-images
Explore UI and visual design with image generation, then iterate the real implementation against the user-selected concept. Use when brainstorming visual directions, offering mockup variants, or implementing an approved generated design; do not stop at the mockups or the first code approximation.
Also in 5 projects that use this
LambenthanSkilldaily-arxiv
每日从 arXiv 拉取新论文,过滤相关性,auto-ingest 高优先级论文,检测 SOTA 更新
Also in 5 projects that use this
LambenthanSkillexp-eval
实验判决门:Review LLM 独立评判实验结果 → 4 种判决路径 → 自动更新 claims confidence、ideas status、graph edges
Also in 5 projects that use this
- +3 more from dzhng
- +5 more from Lambenthan
Other versions192 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 192
- garrytan/gstack★ 141ksame name
- ansible/ansible★ 71ksame name
- docling-project/docling★ 70ksame name
- traefik/traefik★ 65ksame name
- ClickHouse/ClickHouse★ 51ksame name
- temporalio/temporal★ 24ksame name
- tisfeng/Easydict★ 15ksame name
- juicedata/juicefs★ 15ksame name
- elie222/inbox-zero★ 13ksame name
- gitkraken/vscode-gitlens★ 10ksame name
182 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 repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- architectureSkill
- browser-automationSkill
- cli-designSkill
- debugSkill
- experimentSkill
- gauntlet-loopSkill
- get-it-doneSkill
- grillingSkill
- handoffSkill
- implementSkill
- merge-conflictsSkill
- office-filesSkill
- planSkill
- project-contextSkill
- quick-modeSkill
- releaseSkill
- researchSkill
- skill-designSkill
- teachSkill
- testSkill
- triageSkill
- wait-whatSkill
- writingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. 0 are common, 13 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 157 edited versions we read keep these.
13
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
When validity depends on them, record the tested artifact or revision, verifier, environment, entrypoint, authentication context, time, and …
- Distinctive: line 18
Treat summaries and worker success as claims, not proof.
- Distinctive: line 21
When practical, make an independent first pass before reading earlier comments or persuasive self-assessments.
- Distinctive: line 22
After that pass, verify external findings.
- Distinctive: line 27
Every lane or reviewer must name a distinct material risk or evidence gap.
- Distinctive: line 32
Check both directions. Map every acceptance claim to evidence.
- Very specific: line 43
If no material simplification remains, report ALREADY LEAN and stop.
- Distinctive: line 44
Do not invent requirements or infer AI authorship from style.
- Very specific: line 51
Treat severity and repair class separately.
- Distinctive: line 53
Do not open with praise, narrate the review process, or invent minor comments to make the review appear thorough.
- Distinctive: line 55
Do not treat a builder’s unverified self-assessment as evidence.
- Distinctive: line 56
Do not claim standards compliance without scoped verification evidence.
- Distinctive: line 61
Use BCP 14 only for normative force.
- Distinctive: line 62
Before risky or failure-prone work, warn, add any needed hold point and verify the safe state.
- Distinctive: line 64
Avoid surprise scope; leave results usable or resumable.
“Common” is measured: kept by at least 6 in 10 of the 157 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
Review
For review tasks, use an ISO/IEC 20246-inspired structured review of the actual work product.
- Select applicable ISO/IEC 25010 quality attributes. For consequential claims, use an ISO/IEC/IEEE 15026-2-inspired assurance case.
- For user information, use ISO/IEC/IEEE 26513, ISO/IEC/IEEE 26514, IEC/IEEE 82079-1, ISO/IEC 23859, and cognitive-accessibility sources only when the artifact and audience require them.
- Apply Google code-review practice. Protect correctness and code health. Do not block net improvement for hypothetical perfection.
Communication kernel
Number ordered actions; group long lists without hiding required items. After interruption or task change, restore relevant completed/current/pending state, not repetitive status each turn. Preserve language, exact tokens, formats, permissions and evidence. Never invent estimates or diagnose readers. Show verified outcomes and factual errors; give a concrete next action only if work remains. Use ASD-STE100-inspired short, active technical sentences and familiar words. Use ISO 704-inspired stable concepts and terminology. Use Diátaxis organization to separate how-to, reference, and explanation when helpful. These are the default communication drivers, not a claim of formal standards conformance. If trusted root AGENTS.md is loaded, its policy governs. Otherwise apply this standalone kernel. Do not claim root activation without evidence.
Review procedure
- Define the review decision and scope. Recover outcome, non-goals, requirement sources, acceptance, standing Definition of Done, environment and risk. Explain enough current behaviour to avoid reviewing an imagined system.
- Gather evidence from the actual artefact, diff, rendered output, test results, logs, data, startup path or source material.
- Audit the proof mechanism and result. Identify the actual verifier. Confirm that it observes the named outcome and can fail under a representative broken state. Separate historical status from current re-execution.
- When validity depends on them, record the tested artifact or revision, verifier, environment, entrypoint, authentication context, time, and coverage.
- Inventory, mocks, unit tests, harnesses, and bypassed authentication do not prove deployed behavior without relevant equivalence.
- Treat summaries and worker success as claims, not proof.
- For a branch or change set, establish the correct base. Read the specification and tests. Then inspect the diff, full changed files, relevant callers, interfaces, configuration, lockfile or dependency graph, operational commands, and generated artifacts.
- Limit findings to introduced or changed behavior. Trace consequences beyond the diff.
- When practical, make an independent first pass before reading earlier comments or persuasive self-assessments.
- After that pass, verify external findings. Do not accept them without checking.
- For claimed cross-model independence, record the requested reviewer, actual model, verified serving family, context separation, and artifact inspected.
- A different CLI alone does not establish independence. Unverified identity lowers the independence level.
- Delegated review requires live child, tool, or artifact evidence.
- Select only relevant lanes from
LANES.md.- Every lane or reviewer must name a distinct material risk or evidence gap. Do not add review lanes merely because agents are available.
- Give parallel lanes distinct charters and anti-charters.
- For material code changes, check specification or behavioral compliance before maintainability and simplification. Then deduplicate by evidence, not wording.
- A tiny deterministic change MAY need only one focused read and one decisive check.
- Try to disprove success with counterexamples, boundary cases, regressions, alternate calculations, cold startup, or actual user journeys. For a material finding, separate finder from verifier. Choose the uncertainty bias according to the more costly error direction.
- Check both directions. Map every acceptance claim to evidence. Include every material requirement or changed public behavior in the verdict, or explicitly exclude it.
- For consequential user information, test the actual user task and intended audience when practical. A readability or checklist score alone is not proof.
- For a consequential multi-evidence claim, summarize claim, scope, argument, evidence, defeaters, and status.
- Rank findings by evidence and impact:
P0: safety, security, data loss, or irreversible harm;P1: blocks the requested outcome or a hard requirement;P2: meaningful reliability, accessibility, maintainability, performance, documentation, operations, or agent-operability defect;P3: minor preference with low user impact.
- Ignore style nits while P0–P2 defects remain.
- For simplification, classify only evidence-backed opportunities as delete, reuse, standard library, native platform, inline, consolidate, or shrink.
- Judge concepts, owners, dependencies, branches, and behavior before line count.
- If no material simplification remains, report
ALREADY LEANand stop. - Do not invent requirements or infer AI authorship from style. Do not use file length alone as a defect. Do not call an unmeasured concern a measured regression or present a capped sample as exhaustive.
- In repair mode, change only evidence-backed defects. Preserve unrelated work. Rerun affected checks.
- A simplification must reduce net complexity, not move it behind another wrapper.
- Approve a definite net improvement when the contract is met and residuals are nonblocking and owned. Do not block for hypothetical perfection or accept material regression for speed. Flag wording that hides a verified failure, its impact, or an evidenced actor. Preserve legitimate uncertainty and exact source meaning. A negative or hedge is not a defect by itself.
Findings and verdict
For each finding, state ID, severity, repair class (block now, fix before merge, follow-up, or no change), violated requirement, exact evidence, reproduction, expected versus actual, impact, smallest repair direction, confidence, and verification status.
- Treat severity and repair class separately. A
P2MAY still befix before merge. A nonblockingP2needs an owner or revisit trigger beforePASS WITH RISKS. Lead withPASS,PASS WITH RISKS, orFAIL. Then give the highest-severity evidence-backed findings. - Do not open with praise, narrate the review process, or invent minor comments to make the review appear thorough.
- Include executed checks, skipped or failed checks, unprocessed remainder, and remaining uncertainty.
- Do not treat a builder’s unverified self-assessment as evidence.
- Do not claim standards compliance without scoped verification evidence.
User-facing execution rules
- Lead with the supported result, action or blocker. Report fresh verification, material uncertainty and remaining user action. Omit routine tool narration and praise.
- State verified failure and evidenced responsibility directly. Correct actual agent errors or give the next safe action.
- Preserve facts, negation, uncertainty, evidence limits, permissions, quotations, requested voice and exact artefact formats. Style does not prove formal conformance.
- Use BCP 14 only for normative force. Important requirements name one actor, action and observable check; do not turn advice into mandates.
- Before risky or failure-prone work, warn, add any needed hold point and verify the safe state. State the expected result, failure sign and recovery. Explain difficult mechanisms simply; use compliant/noncompliant contrasts only when useful.
- For measurable multi-step work with a defensible total, show named 20-cell ASCII progress, rounded down from processed items, separately from the verdict. Processed does not mean passed. Otherwise report phase and evidence.
- Avoid surprise scope; leave results usable or resumable. Keep simple replies short without truncating needed detail. Omit routine Summary headings and closing recaps. Use TL;DR only when helpful for a complex response, and place it first.
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.

