barotrauma-admin/.opencode/skills/codebase-review-swarm/README.md

Codebase Review Swarm Skill v8.2

Portable Agent Skill for OpenCode, Codex, and Claude Code. It converts the v7 codebase-review swarm prompt into a progressive-disclosure skill package with a short routing-focused SKILL.md, detailed protocol references, parseable schemas, report template, optional Codex metadata, and deterministic helper scripts.

Contents

codebase-review-swarm/
  SKILL.md
  INSTALL.md
  README.md
  agents/
    openai.yaml
  assets/
    jsonl-schemas.md
    review-report-template.md
  references/
    compatibility-and-research-notes.md
    full-v7-source-prompt.md
    review-protocol-v8.2.md
  scripts/
    init-review-run.py
    validate-skill-package.py

Design summary

• Canonical opencode-swarm repo path: .opencode/skills/codebase-review-swarm/.
• Claude path: .claude/skills/codebase-review-swarm/ as a thin adapter to the canonical OpenCode skill.
• Codex path: .agents/skills/codebase-review-swarm/ as a thin adapter with agents/openai.yaml.
• Portable user install paths may still use .agents/skills/, .opencode/skills/, or .claude/skills/ depending on host.
• Frontmatter is intentionally portable: required name and description, plus harmless metadata.
• Long instructions are split into references/assets to preserve routing quality and context budget.
• Focused track selections expand depth inside the selected domain; multi-track/all-track selections add waves rather than sacrificing per-track quality.
• The full v7 prompt is preserved verbatim for detailed track checklists.
• Standards are current as of 2026-06-08: ASVS 5.0.0, OWASP LLM Top 10 2025, SLSA v1.2, WCAG 2.2 AA, OpenTelemetry.

Primary command

$codebase-review-swarm

Begin at repository root. The skill runs Phase 0 inventory, stops for review mode selection unless preselected, then performs selected exhaustive tracks with coverage closure, review-depth planning, non-diluting multi-track execution, and critic validation.