codebase-review-swarm · zaxbyhub, claude — Claude Code skill: how it works and setup
codebase-review-swarm executes quote-grounded codebase audits across security, QA, and performance. Suitable for full-repository assessments where no source files may be touched.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-codeWhat codebase-review-swarm does
This workflow runs deep review sweeps across an entire repository or major subsystems. It is strictly read-only: the agent never edits source files. All generated findings and logs land only inside .swarm/review-v8/runs/<run_id>/.
Execution starts with a Phase 0 inventory. The process halts for track selection unless the user already specified target audit areas. The skill enforces a strict evidence policy: every claim requires an exact code quote. Findings pass through separate reviewer and critic stages before the summary report is finished.
This setup will fail you if you need bug fixing or code changes, because it exclusively produces diagnostic reports.
What it helps with
- audit large codebases without editing any production files
- produce evidence-backed review reports grounded in exact source quotes
- scan repositories for security vulnerabilities, QA gaps, and AI slop
- run multi-stage reviewer and critic passes on architecture findings
Example prompts for the agent
- Run a quote-grounded security and QA audit across the repository using codebase-review-swarm
- Execute Phase 0 inventory and wait for track selection before auditing the auth module
- Inspect the frontend codebase for accessibility defects and AI slop
How to install codebase-review-swarm
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-code2Manually: put the files in place
~/.claude/skills/codebase-review-swarm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/codebase-review-swarm/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a codex2Manually: put the files in place
.agents/skills/codebase-review-swarm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a cursor2Manually: put the files in place
.cursor/skills/codebase-review-swarm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .claude/skills/codebase-review-swarm2Manually: put the files in place
.github/skills/codebase-review-swarm/SKILL.md1Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a gemini-cli2Platform CLI
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .claude/skills/codebase-review-swarmManually: put the files in place
.devin/skills/codebase-review-swarm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about codebase-review-swarm
How to install codebase-review-swarm in Claude Code?
Run npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-code. The workflow will be saved to ~/.claude/skills/codebase-review-swarm/SKILL.md.
What does codebase-review-swarm do?
It coordinates a thorough read-only repository audit across security, performance, QA, and accessibility. Every claim in the generated report must include direct code quotes.
Does codebase-review-swarm modify any source code?
No. The skill operates in read-only mode and writes artifacts exclusively under .swarm/review-v8/runs/<run_id>/.
Source text
SKILL.md · MIT
--- name: codebase-review-swarm description: > Claude Code adapter for running a rigorous, quote-grounded codebase review or security/QA/accessibility/performance/AI-slop/enhancement audit. Use for full-repo or large-subsystem review reports; not for normal implementation. metadata: audience: swarm-plugin --- # Codebase Review Swarm Read and follow `../../../.opencode/skills/codebase-review-swarm/SKILL.md` as the canonical workflow. ## Claude Code Execution Notes - Treat this as a read-only review workflow. Do not modify source files. - Write review artifacts only under `.swarm/review-v8/runs/<run_id>/`. - Run Phase 0 inventory first and stop for review-mode selection unless the user already selected tracks and explicitly authorized continuing. - Preserve the skill's evidence rule: no quote, no claim. - For dispatch lanes, only if the session actually exposes the controller's lane tools, treat `output` as a preview and call `retrieve_lane_output` for full `output_ref` artifacts before consuming ledgers, counting candidates, routing validation, or declaring coverage clean; when those tools are absent, treat inline `output` as the full artifact and disclose any truncation as an explicit coverage limitation. - Use independent reviewer and critic passes before finalizing report findings.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Code review and refactoring →codebase-review-swarm by other authors comes first.