review

Automate spec-aware pull request reviews with CI gating across GitHub, GitLab, and Gitea.

30|2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/joestump/claude-plugin-design --skill review-joestump
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/joestump/claude-plugin-design/tree/main/skills/review
Command: npx skills add https://github.com/joestump/claude-plugin-design --skill review-joestump

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual pull request reviews are time-consuming, inconsistent with architecture specifications, and error-prone when coordinating multiple reviewers and responders across many PRs; this Skill automates spec-aware reviews, enforces CI gating, and reduces human overhead for merging compliant work.

Core Features & Use Cases

  • Reviewer-responder pairs: Coordinate reviewer and responder agents in pairs to perform a single review-response round per PR.
  • Spec & ADR awareness: Load spec.md, design.md, and referenced ADRs to validate acceptance criteria and architectural compliance during reviews.
  • CI gating and merge control: Verify all status checks before reviewing or merging, support configurable merge strategies, dry-run and no-merge modes, and automatic epic closure when appropriate.
  • Tracker integration: Discover and operate with GitHub, GitLab, or Gitea PR/MR workflows using runtime tool discovery and task orchestration.
  • Use case: Run a batch review for SPEC-0003 to validate acceptance criteria across several feature PRs, automatically request changes, accept responses, and merge approved PRs.

Quick Start

Invoke /design:review SPEC-0003 --pairs 2 to review and merge open PRs for that spec using reviewer-responder pairs while enforcing CI checks and the configured merge strategy.

Frequently Asked Questions about review

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

FAQPage Schema
How do I automate pull request reviews for spec-linked PRs?

Automated pull request reviews use reviewer-responder agent pairs to validate spec.md, design.md, and ADR acceptance criteria, enforce CI green checks, and merge compliant PRs across GitHub, GitLab, or Gitea workflows.

Can I enforce CI green checks before merging a pull request?

Yes, CI gating verifies all status checks pass before reviewing or merging pull requests. You can configure merge strategies, use dry-run mode to preview results, or set no-merge flags to review without merging.

How do I run a batch code review for multiple feature PRs tied to one spec?

Invoke a batch review for a specific spec to validate acceptance criteria across several feature PRs simultaneously, automatically request changes, accept responses from responder agents, and merge approved PRs when CI passes.

Does automated PR review work with GitLab and Gitea as well as GitHub?

Yes, automated PR review supports GitHub, GitLab, and Gitea workflows using runtime tool discovery and task orchestration to operate across different tracker integrations for PR and MR processing.

How does spec and ADR compliance validation work during code review?

Spec and ADR compliance validation loads spec.md, design.md, and referenced ADRs to verify architectural compliance and validate acceptance criteria during the pull request review process.

Can I review pull requests without actually merging them?

Yes, you can use dry-run and no-merge flags to review pull requests and enforce CI checks without executing the merge, allowing safe validation and architectural compliance checks before final integration.