review-team

Automate GitHub PR reviews with a five-member adversarial team.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/swallville/tax-calculator --skill review-team-swallville
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-team
Source: https://github.com/swallville/tax-calculator/tree/main/.claude/skills/review-team
Command: npx skills add https://github.com/swallville/tax-calculator --skill review-team-swallville

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, adversarial PR review process to surface high-confidence findings before merging by coordinating a five-member team.

Core Features & Use Cases

  • Orchestrates a five-member PR review team: four specialists plus a Devil's Advocate to challenge findings.
  • Generates findings with confidence ratings and compiles a final report to inform decisions.
  • Applies ticket and project conventions to maintain alignment with project standards.

Quick Start

Provide a PR URL to start the five-member review workflow.

Frequently Asked Questions about review-team

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

FAQPage Schema
How do I automate adversarial PR reviews on GitHub to catch high-risk issues before merging?

Adversarial PR reviews are automated by a five-member team—staff-engineer, qa-engineer, security-reviewer, architect, and devils-advocate—that cross-examines diffs and metadata to generate high-confidence findings. The team fetches GitHub PR context and aggregates results into a final report.

What is the best way to apply project conventions and ticket context during code review?

Project conventions and ticket context are applied during code review by enforcing CLAUDE.md standards and fetching ticket metadata alongside the PR diff. This ensures the automated review process maintains alignment with your established project standards.

How does the Devil's Advocate role work in an automated code review process?

The Devil's Advocate role works in an automated code review process by challenging the findings produced by the four specialist reviewers. This phase-based cross-examination step filters out weak observations, ensuring only high-confidence findings remain in the final aggregated report.

Can I use this automated review process with my existing GitHub workflow without extra dependencies?

Yes, you can use this automated review process with your existing GitHub workflow without extra dependencies. It operates independently by fetching PR diffs, metadata, and ticket context, while persisting its own state locally under a .review-team directory.

How do I start a team-based PR review using a GitHub PR URL?

To start a team-based PR review, provide a GitHub PR URL to initiate the workflow. The five-member review team will then fetch the diff, assign specialist tasks, execute the cross-examination phase, and compile the final review report.

What are the limitations of using an automated five-member team for risk assessment in PR reviews?

A limitation of using an automated five-member team for risk assessment is that the review quality depends heavily on the fetched diff and ticket context. Complex architectural nuances or unwritten team conventions not explicitly documented in the metadata may be missed during the automated cross-examination.