review

Coordinate parallel adversarial agents to review code changes and output a unified triage report.

Updated Nov 4, 2022
One-click install
npx skills add https://github.com/CityBear3/dotfiles --skill review-citybear3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/CityBear3/dotfiles/tree/main/claude/skills/review
Command: npx skills add https://github.com/CityBear3/dotfiles --skill review-citybear3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps engineers catch correctness, robustness, API misuse, performance, and test gaps by running a structured, multi-agent review in parallel and producing a single unified report with triage-ready recommendations.

Core Features & Use Cases

  • Parallel verification + adversarial review: Runs design alignment, scope completeness, and test coverage checks concurrently with adversarial robustness, API, performance, and test-weakness hunts.
  • Fail-safe context bundling: Builds a context bundle from design docs, plans, project rules, and language hints (including optional hints files) to ground reviewer outputs.
  • Action-oriented unified reporting: Integrates adversarial findings and presents a standardized report including a prioritized Must Fix / Should Improve section.

Quick Start

Use the review skill by asking the AI to run a comprehensive code review for the current branch changes.

Frequently Asked Questions about review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an adversarial code review to catch API misuse and performance gaps?

An adversarial code review runs parallel verification agents and adversarial hunts for API misuse, performance, and test weaknesses. It coordinates 7 agents concurrently to identify defects and output a unified report with triage-ready Must Fix or Should Improve recommendations.

What is a multi-agent code review and how does it work?

A multi-agent code review coordinates multiple specialized agents in parallel to evaluate changed code. It runs design alignment, scope completeness, test coverage, robustness, API safety, and performance checks concurrently, integrating findings into a single prioritized report.

How do I perform a code review that aligns with design docs and project rules?

Perform a context-grounded code review by building a fail-safe context bundle from design documents, plans, project rules, and language hints. This bundle grounds the parallel reviewer agents, ensuring findings align with your specified design constraints and project standards.

Can I use automated code review to triage defects and test coverage gaps?

Yes, automated code review can triage defects and test coverage gaps by running structured verification checks concurrently with adversarial test-weakness hunts. It integrates these findings into a standardized, action-oriented report with prioritized Must Fix or Should Improve sections.

Does multi-agent code review work for reviewing branch changes after verification passes?

Yes, multi-agent code review is designed for reviewing files or branches after verification passes or when explicitly requested. It applies parallel agents to identify robustness, correctness, and API safety risks across the changed code.

What are the limitations of automated adversarial code review?

Automated adversarial code review requires a fail-safe context bundle from design docs and project rules to ground its agents. Without these inputs, the 7 parallel agents may lack the shared context needed to accurately identify scope completeness and design alignment gaps.