review-swarm
Parallel read-only multi-agent review of a current git diff or explicit file scope to find behavioral regressions, security or privacy risks, performance or reliability issues, and contract or test coverage gaps
Install / Use
npx skills add Dimillian/Skills --skill review-swarmInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of review-swarm
review-swarm scores 82/100 on our quality scale, 959th of 1,111 Security skills we index.
Its SKILL.md is 6.4 KB long, well organised into 10 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 3,979 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-07 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 94/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
review-swarm compared with similar skills
All 4 of these similar skills score higher than review-swarm; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| review-swarm (this skill)by Dimillian | 82 | 4.0k | 8mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install review-swarm?
- Run
npx skills add Dimillian/Skills --skill review-swarm. The install tabs above show the steps for each supported agent. - Which AI agents does review-swarm work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is review-swarm safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 94/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is review-swarm still maintained?
- The repository was last updated about 8 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: review-swarm description: "Parallel read-only multi-agent review of a current git diff or explicit file scope to find behavioral regressions, security or privacy risks, performance or reliability issues, and contract or test coverage gaps. Use when the user asks for a review swarm, parallel review, diff review, regression review, security review, or wants high-signal issues plus a prioritized fix path without editing files."
Review Swarm
Review a diff with four read-only sub-agents in parallel, then have the main agent filter, order, and summarize only the issues that matter. This skill is review-only: sub-agents do not edit files, and the main agent does not apply fixes as part of this workflow.
Step 1: Determine Scope and Intent
Prefer this scope order:
- Files or paths explicitly named by the user
- Current git changes
- An explicit branch, commit, or PR diff requested by the user
- Most recently modified tracked files, only if the user asked for a review and there is no clearer diff
If there is no clear review scope, stop and say so briefly.
When using git changes, choose the smallest correct diff command:
- unstaged work:
git diff - staged work:
git diff --cached - mixed staged and unstaged work: review both
- explicit branch or commit comparison: use exactly what the user requested
Before launching reviewers, read the closest local instructions and any relevant project docs for the touched area, such as:
AGENTS.md- repo workflow docs
- architecture or contract docs for the touched module
Build a short intent packet for the reviewers:
- What behavior is meant to change
- What behavior should remain unchanged
- Any stated or inferred constraints, such as compatibility, rollout, security, or migration expectations
If the user did not state the intent clearly, infer it from the diff and say that the inference may be incomplete.
Step 2: Launch Four Read-Only Reviewers in Parallel
Launch four sub-agents when the scope is large enough for parallel review to help. For a tiny diff or one very small file, it is acceptable to review locally instead.
For every sub-agent:
- give the same scope and the same intent packet
- state that the sub-agent is read-only
- do not let the sub-agent edit files, run
apply_patch, stage changes, commit, or perform any other state-mutating action - ask for concise findings only
- ask for: file and line or symbol, issue, why it matters, recommended follow-up, and confidence
- tell the sub-agent to avoid nits, style preferences, and speculative concerns without concrete impact
- tell the sub-agent to send findings back to the main agent only
Use these four review roles.
Sub-Agent 1: Intent and Regression Review
Review whether the diff matches the intended behavior change without introducing extra behavior drift.
Check for:
- Unintended behavior changes outside the stated scope
- Broken edge cases or fallback paths
- Contract drift between callers and callees
- Missing updates to adjacent flows that should change together
This sub-agent is read-only. It must not edit files, apply patches, or make any other workspace changes.
Recommended sub-agent role: reviewer
Sub-Agent 2: Security and Privacy Review
Review the diff for security regressions, privacy risks, and trust-boundary mistakes.
Check for:
- Missing or weakened authn or authz checks
- Unsafe input handling, injection risks, or validation gaps
- Secret, token, or sensitive data exposure
- Risky defaults, permission expansion, or trust of unverified data
This sub-agent is read-only. It must not edit files, apply patches, or make any other workspace changes.
Recommended sub-agent role: reviewer
Sub-Agent 3: Performance and Reliability Review
Review the diff for new cost, fragility, or operational risk.
Check for:
- Duplicate work, redundant I/O, or unnecessary recomputation
- Added work on startup, render, request, or other hot paths
- Leaks, missing cleanup, retry storms, or subscription drift
- Ordering, race, or failure-handling problems that make the change brittle
This sub-agent is read-only. It must not edit files, apply patches, or make any other workspace changes.
Recommended sub-agent role: reviewer
Sub-Agent 4: Contracts and Coverage Review
Review the diff for compatibility gaps and missing safety nets.
Check for:
- API, schema, type, config, or feature-flag mismatches
- Migration or backward-compatibility fallout
- Missing or weak tests for the changed behavior
- Missing logs, metrics, assertions, or error paths that make regressions harder to detect
This sub-agent is read-only. It must not edit files, apply patches, or make any other workspace changes.
Recommended sub-agent role: reviewer
Report only issues that materially affect correctness, security, privacy, reliability, compatibility, or confidence in the change. It is better to miss a nit than to bury the user in low-value noise.
Step 3: Aggregate and Filter Findings
The main agent owns synthesis. Treat sub-agent output as raw review input, not final output.
Merge findings across all four reviewers and filter aggressively:
- drop duplicates
- drop weak or speculative claims
- drop issues that conflict with the stated intent
- drop minor style or readability comments unless they hide a real bug or maintenance risk
Normalize surviving findings into this shape:
- File and line or nearest symbol
- Category: regression, security, reliability, or contracts
- Severity: high, medium, or low
- Why it matters
- Recommended fix or follow-up
- Confidence: high, medium, or low
If a reviewer may be correct but the intent is unclear, turn it into an open question instead of a finding.
Step 4: Order the Output
Present findings in this order:
- High-severity, high-confidence issues
- Medium-severity issues that are likely worth fixing before merge
- Lower-severity issues or follow-ups that can wait
Keep the review concise. Findings should be actionable and evidence-backed.
If there are no material issues, say that directly instead of manufacturing feedback.
Step 5: Recommend a Clear Path Forward
After the findings, give the user a short path forward:
- what to fix before merge
- what to improve if time permits
- what can safely be left alone
When helpful, group the path forward into:
fix nowfix soonoptional follow-up
Do not implement fixes as part of this skill. The output is a read-only review plus a prioritized recommendation.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
