Can it merge PRs automatically?

Yes, unless the --no-merge flag is used, the skill will automatically squash and merge approved PRs once all CI checks have passed.

What platforms does the review skill support?

It currently supports GitHub, GitLab, and Gitea for managing Pull Requests and Merge Requests via their respective CLIs and APIs.

How do reviewer-responder pairs work?

One agent acts as the reviewer to check the code against specifications, while a second responder agent makes the necessary code changes in a worktree to address any feedback provided.

What happens if CI checks fail?

The skill strictly enforces quality; it will block the review and merge process until all status checks are green, reporting the blocked status back to the lead user.

Does it require specific documentation?

It is designed to work with OpenSpec files and Architecture Decision Records (ADRs) to provide context-aware feedback based on your specific project requirements.

Spec-Aware PR Reviewer

Name: Spec-Aware PR Reviewer
Author: joestump

byjoestump

•

Collaboration Tools

Automates pull request reviews and merges using spec-aware agent pairs to ensure strict architectural compliance.

This skill implements a sophisticated multi-agent workflow to handle code reviews, specifically optimized for projects using the design-driven development pattern. By pairing a reviewer agent with a responder agent, the skill doesn't just identify issues—it proactively addresses them within the PR. It validates code changes against Architecture Decision Records (ADRs) and OpenSpec specifications, ensuring every contribution aligns with the project's established design goals. It manages the entire lifecycle from CI verification to squash merging and automatic epic closure across GitHub, GitLab, and Gitea.

Key Features

01Architecture-Aware Validation: Checks diffs against ADRs and OpenSpec requirements to prevent architectural drift.

024 GitHub stars

03Automated CI Verification: Ensures all status checks pass before proceeding with reviews or final merges.

04Reviewer-Responder Agent Pairs: Uses two-agent teams to both critique and fix code issues automatically.

05Epic Lifecycle Management: Automatically identifies and closes parent epics once all associated stories are merged.

06Multi-Platform Support: Deep integration with GitHub, GitLab, and Gitea for PR/MR management.

Use Cases

01Ensuring strict adherence to project-specific design specs and ADRs during high-velocity development.

02Automating the repetitive loop of addressing minor feedback and re-validating PRs.

03Scaling code review processes for complex architectural changes without manual bottlenecks.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design review

For use in Claude.ai and ChatGPT

Download Skill