Skip to main content
skill CX Codex

codebase-review-swarm · zaxbyhub, opencode — Claude Code skill: code audits and setup

The codebase-review-swarm skill audits a repository and ties each finding to source evidence. Use it for focused security, QA, accessibility, performance, or other review tracks.

MIT ★ 539 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-code
Open on GitHub

What codebase-review-swarm does

The skill inventories the repository, then examines the review tracks the user selects, such as security, testing, accessibility, performance, or provenance. Findings must cite a file path, line range, and exact excerpt. A reviewer checks candidates; critical and high-severity defects also go through critic validation.

The workflow pauses after inventory for a review-mode choice unless the request already names tracks and authorizes continuing. Every coverage unit must reach a final status before the report can be completed. Reports and supporting files go under .swarm/review-v8/, while source files remain unchanged. On OpenCode, install it with npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a opencode.

What it helps with

  • audit repository security with source-backed findings
  • track QA coverage through a complete review report
  • inspect UI accessibility against WCAG 2.2 AA
  • separate broken behavior from enhancement ideas
  • review build and release provenance

Example prompts for the agent

  • Audit repository security, then pause after inventory so I can choose the review mode.
  • Review the full project for QA and accessibility; continue with those tracks.
  • Create an enhancement catalog for this subsystem and validate each finding against source evidence.

How to install codebase-review-swarm

1Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-code

2Manually: put the files in place

~/.claude/skills/codebase-review-swarm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codebase-review-swarm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codebase-review-swarm

How do I install codebase-review-swarm in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill codebase-review-swarm -a claude-code. The skill is placed at ~/.claude/skills/codebase-review-swarm/SKILL.md.

What does codebase-review-swarm do?

It reviews selected areas of a codebase and prepares a report grounded in source excerpts. It does not edit source files.

Why does the skill pause after its inventory?

It asks the user to select a review mode unless the request already specifies tracks and permits the workflow to continue. It then plans coverage for the selected tracks.

Source text

SKILL.md · MIT
---
name: codebase-review-swarm
description: Run 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. Performs Phase 0 inventory, selected exhaustive tracks with non-diluting depth, coverage closure, reviewer/critic validation, and writes .swarm/review-v8 artifacts without modifying source files.
license: MIT
metadata:
  version: "8.2.0"
  generated: "2026-06-08"
  source_prompt: "codebase-review-swarm-prompt-v7"
  artifact_root: ".swarm/review-v8/runs/<run_id>/"
  audience: swarm-plugin
---

# Codebase Review Swarm

Use this skill when the user asks for a deep codebase audit, full QA review, security review, supply-chain review, AI-slop/provenance review, UI/accessibility review, performance/observability review, or enhancement catalog. Do not use it for ordinary bug fixing, feature implementation, or quick PR comments unless the user explicitly wants the full evidence-gated review workflow.

You are the Architect/orchestrator. You produce a verified review report and supporting artifacts. You do not modify source files. Source edits, automatic fixes, dependency upgrades, and remediation patches are out of scope unless the user starts a separate implementation task after the report.

## Graph-first evidence contract

Start review scope with `repo_map` `graph_health` and a targeted source-bearing `context_pack`. For security, trust-boundary, and data-flow tracks, add `route_trace` and `data_trace`. Graph evidence is advisory only. If freshness is stale or inconclusive, confidence is low, source is missing, the language is unsupported/dynamic, the graph is absent, or an action fails, inspect the direct source and searches before accepting a finding.

## Load order

Read these files before executing:

1. `references/review-protocol-v8.2.md` - authoritative workflow, phases, track contracts, and standards.
2. `assets/jsonl-schemas.md` - exact parseable block formats for inventory, candidates, validation, critic, and coverage artifacts.
3. `assets/review-report-template.md` - final `review-report.md` structure.
4. `references/full-v7-source-prompt.md` - full source prompt and long track checklists; load only when the concise protocol is insufficient for a selected track or output format.

Optional deterministic helpers:

- `scripts/init-review-run.py` creates the `.swarm/review-v8/runs/<run_id>/` artifact tree and warns if `.swarm/` is not ignored.
- `scripts/validate-skill-package.py` checks the local skill package shape.

## Non-negotiable invariants

1. **No Quote, No Claim.** Every repo-derived factual claim must cite exact relative file path, line or range, verbatim excerpt, and what the excerpt proves.
2. **Coverage closure.** Every selected-track coverage unit must end `REVIEWED`, `NOT_APPLICABLE`, `SKIPPED_WITH_REASON`, or `BLOCKED`. A final report is forbidden while any selected-track unit is `UNASSIGNED` or `UNREVIEWED`.
3. **Depth scales with focus and never dilutes with breadth.** Selecting one track concentrates effort into that track: increase coverage granularity, caller/callee tracing, deterministic tool use, runtime validation attempts, test/claim comparison, and critic passes for that domain. Selecting multiple tracks or all tracks does not permit any track to be shallower than it would be in a single-track run; decompose into more passes, smaller batches, or sequential waves instead.
4. **Candidates are not findings.** Explorer output is candidate evidence only. Reviewer validation filters false positives. Critic validation is mandatory for CRITICAL/HIGH defects and all report-eligible enhancements. Final whole-report critic must PASS before completion.
5. **Deterministic before judgment.** Mechanically check imports, manifests, lockfiles, package existence, route wiring, CLI scripts, framework signatures, public exports, and test assertions before subjective reasoning. Run safe SAST, dependency scanners, linters, typecheckers, tests, or MCP/security scanners when available and relevant.
6. **Disproof required.** Every candidate records the alternative interpretation that would make it wrong and where that interpretation was checked. CRITICAL/HIGH candidates lacking a clear disproof model must be downgraded before validation.
7. **Runtime validation when runtime matters.** Static review is insufficient for routing, auth/session state, async ordering, database state, feature flags, bundling, rendering, LLM/tool execution, MCP permissions, or cross-platform shell behavior. Run the smallest safe validation or mark the item `UNVERIFIED`.
8. **Separate defects from enhancements.** Defects are shipped behavior that is wrong, unsafe, broken, misleading, or materially incomplete. Enhancements improve working code without implying breakage. Do not duplicate the same root issue in both forms.
9. **Evidence-based AI slop only.** Never report "looks generated" findings. Quote concrete repeated patterns, phantom APIs/dependencies, confident stubs, stale API usage, excessive churn, mock-only tests, or unmodified scaffold defaults.
10. **Quality over speed.** Parallelize only independent scopes. If quality and concurrency conflict, quality wins.
11. **No fixed budget compression.** Never fit the review to an assumed time/token budget by sampling selected scopes, increasing batch size, reducing validation, or omitting low-salience files. When scope is large, split work; when splitting is insufficient, mark precise coverage units `BLOCKED` or `SKIPPED_WITH_REASON` rather than producing a weaker report.

## Current standards to apply

Use these baselines unless repository policy explicitly requires stricter or older controls:

- OWASP ASVS 5.0.0 for web application control review.
- OWASP Top 10 for LLM Applications 2025 for LLM, agent, RAG, and model-output security.
- SLSA v1.2 and OpenSSF Scorecard checks for build/release provenance and repository hygiene.
- WCAG 2.2 AA for UI accessibility.
- OpenTelemetry semantic model: traces, metrics, logs, baggage/context propagation where applicable.

## Execution outline

1. Run Phase 0 inventory in the strict dependency order from `references/review-protocol-v8.2.md` and write the source-of-truth packet.
2. Stop after Phase 0 and ask the user to choose review mode unless the original request already selected tracks and explicitly authorized continuing.
3. Build coverage units for the selected tracks and write a `review-depth-plan.md` that proves each selected track receives full-depth treatment.
4. Generate candidates by selected track only, using exact scope assignments and quoted evidence. Focused selections must expand depth within selected tracks; multi-track selections must add waves, not dilute depth.
5. Validate candidates in small local reasoning batches.
6. Run inline critic for CRITICAL/HIGH defects, enhancement critic for all kept enhancements, and final whole-report critic.
7. Write `review-report.md` only after coverage closure and final critic PASS.
8. Final response reports only the run path, selected tracks, counts summary, highest-risk items, coverage limitations, and confirmation that no source files were modified.

## Pre-flight: PR Branch Checkout Before Explorer Dispatch

When the review target is a PR branch or commit range, complete this before any
explorer or candidate-generation dispatch:

1. Verify the working tree is clean with `git status --porcelain`. If
   uncommitted changes exist, **you (the orchestrator)** must handle them
   before any explorer/candidate dispatch — use `prepare_pr_workflow_checkout`
   (the controller-owned path; it preserves every dirty path — including
   untracked files when called with no `paths` argument — and returns a recovery
   command), or a git worktree (see `running-tests` skill precedent). Note:
   `git branch tmp/save-<topic>` only moves the HEAD ref — it does not record or
   preserve uncommitted working-tree changes, so do not rely on it to save dirty
   work. **Never delegate `git stash`, `git reset`, `git checkout -- .`,
   or `git restore` to subagents** — these are worktree-global operations that
   destroy sibling agents' in-flight work under parallel execution.
2. Fetch and check out the PR head branch locally. Explorer agents read the
   working-tree filesystem (`Read`/`Glob`/`Grep`), not git history, so reviewing
   a PR while the base branch is checked out produces invalid candidates.
3. Record the exact commit range (`base_ref..head_ref`) in the source-of-truth
   packet and pass that range in every explorer/candidate-generation delegation
   so agents have revision context for targeted `git show` inspection.

**Subagent prohibition — must reach every subagent prompt:**
Include this line verbatim in every explorer/candidate-generation lane
or subagent dispatch prompt:
"You are a subagent sharing a worktree with sibling agents. You MUST
NOT run `git stash`, `git reset`, `git checkout -- .`, `git restore`,
or any other worktree-global destructive git command. These destroy
sibling agents' in-flight work without error."

## Async advisory lanes

When selected-track inventory or candidate generation decomposes into independent read-only units, launch those units with `dispatch_lanes_async` when available. Record each returned `batch_id`, then continue architect-owned deterministic work that does not depend on lane output: update the coverage ledger shell, run safe local tools, prepare validation shards, and document unresolved coverage units. Do not mark coverage `REVIEWED`, promote candidates to findings, or write the final report from running lanes.

**Incremental collection:** While lanes are running, poll with `collect_lane_results` (without `wait` or `wait: false`) to check progress and process any settled lanes immediately — call `retrieve_lane_output` for full text when `output_ref` is present, extract candidates, update coverage ledger entries, validate output quality — while continuing independent work between polls. Only use `wait: true` if lanes are still pending and no more independent architect work remains.

At every coverage, validation, and synthesis boundary, all lanes in the relevant batch must be settled before proceeding. Missing, stale, cancelled, or failed lanes are coverage gaps that must be closed before proceeding — they map to the existing `BLOCKED` invariant (#2 Coverage Closure) but with stricter resolution: (1) retry max 2 times with materially different parameters; (2) if retries fail, deploy a verified equivalent alternative (same agent type, same prompt, same scope, same isolation — different dispatch mechanism acceptable when equivalence is verified, including Task-tool dispatch as the final fallback when lane tools do not work); (3) if no equivalent exists, the coverage unit becomes `BLOCKED` and the architect must surface the lane failure to the user before producing a report. `SKIPPED_WITH_REASON` is not acceptable for dispatch-lane failures — it must be `BLOCKED` with an explicit retry/equivalent/escalation trail, and no degraded review report is written.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for Code review and refactoring →

codebase-review-swarm by other authors comes first.

codebase-review-swarm ZaxbyHub 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. CX Codex +1 ★ 539repo stars codebase-review-swarm ZaxbyHub 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. CX Codex +1 ★ 539repo stars oma-qa First Fluke The oma-qa skill for Claude Code and Codex reviews changes for security, performance, accessibility, and correctness. It checks a diff, runs relevant tools, and reports reproducible findings with fixes. CX Codex +1 ★ 1,472repo stars review-swarm Dimillian review-swarm runs a parallel read-only review of a git diff or selected files. Use it to surface regressions, security concerns, and missing test coverage before merging. CX Codex +1 820installs review-loop sangrokjung review-loop runs an adversarial verification loop where a fresh, isolated checker inspects behavioral changes until reaching a strict APPROVE verdict. CX Codex +1 ★ 880repo stars adversarial-review syahiidkamil adversarial-review subjects fresh builds to hostile inspection using isolated reviewer contexts and mandates empirical reproduction on the running system. CX Codex +1 ★ 406repo stars code-review-swarm ruvnet code-review-swarm deploys coordinated AI review agents against pull requests via the GitHub CLI. It flags security flaws and architecture drift before merging. CX Codex ★ 850repo stars squirrelscan squirrelscan squirrelscan connects website audits across 22 categories, covering SEO, speed, security, and accessibility. It delivers machine-readable findings so your coding agent can apply fixes right away. CX Codex +1 ★ 322repo stars

From the same set121

The whole set →
deep-research deep-research runs a multi-step fact-checked research loop with live web search, parallel worker synthesis, and strict claim citation. CX Codex +1 ★ 539repo stars docs-specialist The docs-specialist subagent audits project docs against the code, then helps revise them. Use it to check a README, API reference, or tutorial set. CX Codex +1 ★ 539repo stars swarm Swarm mode for the agent: parallel exploration, an independent reviewer, a critic, and a closeout gate that blocks completion until the diff passes. CX Codex +1 ★ 539repo stars ai_slop_reviewer ai_slop_reviewer audits codebases for empty stubs, hallucinated dependencies, testing theater, and LLM-generated structural flaws before production release. CX Codex +1 ★ 539repo stars specify Turns on SPECIFY mode: the agent checks which spec is effective in the repo, then writes .swarm/spec.md with requirements and success criteria. CX Codex +1 ★ 539repo stars ci-fixer ci-fixer is a Claude Code subagent that diagnoses and remediates GitHub Actions pipeline failures layer by layer in opencode-swarm. CX Codex +1 ★ 539repo stars ci-fix-monitor The ci-fix-monitor skill checks a PR’s CI results, diagnoses failed checks from their logs, and guides fixes and another push. Use it when a PR has red checks. CX Codex +1 ★ 539repo stars issue-tracer2 issue-tracer2 pulls in a GitHub Issue, works through a chain of hypotheses to pin down the root cause, and carries the fix through to tests and a PR. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open