codebase-review-swarm · zaxbyhub — Claude Code skill: install and usage
codebase-review-swarm runs quote-grounded code reviews and security or QA audits without editing project files. Built for deep inspections across entire codebases or large subsystems.
MIT ★ 539 updated 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-codeWhat codebase-review-swarm does
This skill manages multi-track code audits strictly in read-only mode. It begins with a Phase 0 repository inventory and halts until audit modes are chosen. All run artifacts and ledgers are written directly to .swarm/review-v8/runs/<run_id>/, protecting your source tree from accidental edits.
The workflow enforces a strict rule: every finding must be backed by an exact code quote. To verify findings, the agent runs rg, reads target files, and runs shell validations. If fixes are requested once the audit completes, the workflow insists on starting an independent implementation task rather than patching code during the review run.
What it helps with
- audit codebase security and QA issues without touching source files
- detect low-grade AI code and accessibility flaws across subsystems
- generate evidence-backed audit reports verified by file quotes
- inventory repository assets before major refactoring sessions
Example prompts for the agent
- Run a read-only security and QA review across the entire repository.
- Start Phase 0 inventory and audit the backend for performance issues.
- Check the codebase for AI slop and generate a quote-backed report.
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 .agents/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 .agents/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 skill file will be stored at ~/.claude/skills/codebase-review-swarm/SKILL.md.
What does codebase-review-swarm do?
It conducts structured code and security audits across repositories, generating evidence-based reports supported by exact code citations.
Does codebase-review-swarm modify any project files?
No, it runs strictly in read-only mode and saves all output under .swarm/review-v8/runs/<run_id>/.
Source text
SKILL.md · MIT
--- name: codebase-review-swarm description: > Codex 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. ## Codex 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 `rg`, focused file reads, targeted shell commands, and independent validation to close coverage units before writing the final report. - If the user asks for fixes after the report, start a separate implementation workflow rather than editing during the review run.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Similar skills
All skills for Code review and refactoring →codebase-review-swarm by other authors comes first.