review-swarm
Skill20 starsChanged 22 days agoMITView on GitHub
Use when a result, manuscript, derivation, or diff needs independent review. Runs clean-room multi-agent review loops across Claude/Gemini/Codex/OpenCode/Kimi with strict review-contract checks, fallback policy, and convergence gates.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- itgenius-au/skills-librarytheir own version, first seen Nov 1, 2026
- cill-i-am/skillstheir own version, first seen Oct 20, 2026
- alonbaron/claude-skillstheir own version, first seen Oct 12, 2026
- Adhamxon/claude-code-skillstheir own version, first seen Jul 30, 2026
- ReinaMacCredy/Skillstheir own version, first seen Apr 4, 2026
- Dimillian/Skillstheir own version, first seen Mar 6, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- Dimillian/Skills★ 4ksame name
- alonbaron/claude-skills★ 13same name
- Adhamxon/claude-code-skills★ 2same name
- ReinaMacCredy/Skills★ 2same name
- cill-i-am/skills★ 1same name
- itgenius-au/skills-library★ 1same name
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 repository34 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- citation-triangulationSkill
- claim-groundingSkill
- claude-cli-runnerSkill
- codex-cli-runnerSkill
- deep-literature-reviewSkill
- derivation-verifySkill
- dsh-cli-runnerSkill
- figure-hygieneSkill
- gemini-cli-runnerSkill
- hep-calcSkill
- hep-mcp-usageSkill
- idea-allocationSkill
- idea-generationSkill
- idea-pairwise-matchSkill
- idea-posteriorSkill
- julia-packageSkill
- julia-perfSkill
- kimi-cli-runnerSkill
- literature-graph-builderSkill
- literature-to-packageSkill
- markdown-hygieneSkill
- numerical-reliability-gateSkill
- opencode-cli-runnerSkill
- paper-reviserSkill
- pdg-lookupSkill
- physics-diagramsSkill
- referee-reviewSkill
- research-harnessSkill
- research-integritySkill
- research-teamSkill
- research-writerSkill
- zotero-importSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Read each applicable reference before the named operation.
“Common” is measured: kept by at least 6 in 10 of the 6 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 Swarm
Use this skill for independent review of a result, manuscript, derivation or diff. New multi-reviewer work uses scripts/bin/run_multi_task.py; a single advisory reviewer uses scripts/bin/review_one.py, which delegates to that same launcher. Resolve commands and code paths from this skill directory. The canonical public skill name is review-swarm.
Mandatory boundaries
- Match the review investment to the artifact. Result-bearing, public-surface and irreversible artifacts warrant a second seat; cross-family review is preferred, not universally required. Internal implementation work closes on an independent single-family review plus local tests, never the author's tests alone. Record honest degradation and each independence axis.
- A completed seat must be successful, contract-valid, uncontaminated and supported by exact identity evidence. Different routes or aliases do not establish different model families. Roster availability cannot substitute for completed quorum. Native reviewers stay outside launcher aggregation unless deliberately executed through its configured runner.
- Give reviewers the material and neutral question, without prior verdicts or the author's initial judgment. Sealed derivation/recomputation receives only frozen raw inputs, persists its result and terminates before the candidate-visible comparison. Tool mode, ambient context, operator instructions and actual post-fallback execution affect independence; absence of a contamination flag is no attestation.
- Acceptance requires zero BLOCKING findings, HIGH findings fixed or attached to their named acceptance point, and every LOW dispositioned. Apply the stricter grade when schemes overlap. Batch fixes and obtain independent confirmation on the current artifact; default maximum is five candidate review rounds, then narrow or escalate. Lexical Jaccard similarity is not scientific acceptance.
- A verdict applies only to its frozen inputs. Require
FRESHimmediately before folding; changed bytes invalidate acceptance. A malformed delivery is unfinished delivery: bounded same-model normalization first, then documented fallback or honest unavailability. The leader cannot transcribe it into a valid vote. Missing, partial, unchecked, unavailable or stale evidence never counts as acceptance. - Static reading does not certify runtime preconditions, numerical reproduction or load-bearing structural claims. Use the applicable executing / candidate-withheld roles below and record what each check could falsify. A well-formed report or signed runtime capture proves neither provider truth nor scientific correctness.
Read only the relevant procedure
Read each applicable reference before the named operation. References retain the detailed binding contracts and executable examples.
| Operation | Required reading |
| Select panel size, decide whether a second seat is owed, or scope an internal diff | review-scope.md |
| Choose native versus CLI seats, establish identity/family quorum, or degrade an unavailable roster | execution-and-identity.md |
| Launch multiple seats or interpret convergence similarity | launcher-invocation.md |
| Launch one reviewer or assemble a source-extraction packet | single-reviewer-invocation.md and applicable review-one-flags.md |
| Fix, confirm, reuse or fold a verdict | gate-loop-and-freshness.md and delivery-and-runtime-evidence.md |
| Establish current full-notebook acceptance | notebook-content-review.md; whole current original text and dependencies are always required, including confirmation |
| Establish a method precondition or runtime invariant | execution-adversary.md; execute at the result's production configuration |
| Transcribe or extract source material | source-fidelity-review.md; candidate-withheld extraction precedes comparison, including source/correction provenance and visual PDF checks when applicable |
| Review rendered artifacts, claim a published-value match, or certify a load-bearing structural claim | result-and-artifact-roles.md; choose every applicable role, not only one |
| Dispatch any independent reviewer, especially a sealed derivation or recomputation | reviewer-isolation.md |
| Select model defaults, handle failures or override runner tools/prompts/deadlines | model-selection.md, then fallback-and-outages.md or backend-overrides-and-tool-modes.md as applicable |
Request opt-in criteria-first --two-phase review | two-phase-protocol.md; this does not seal a derivation |
| Locate outputs or compare runner delivery capabilities | outputs-and-runner-parity.md |
For a single correctness reviewer, after reading the applicable scope, identity and isolation contracts:
python3 scripts/bin/review_one.py \
--model codex/default \
--artifact /path/to/notes.md \
--role correctnessOmitted/default model selections use the backend's configured default; never inject a historical model name. This one-seat result remains advisory where the artifact warrants another seat.
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.

