How does this skill find relevant documents?

It analyzes the files changed in a PR, maps them to modules using CLAUDE.md files, and searches project directories like docs/proposals and docs/decisions for matching context.

What kind of documentation does it support?

It is designed to surface RFCs (Proposals), Development Plans, and Architecture Decision Records (ADRs) that follow standardized naming conventions.

Do I need the GitHub CLI installed?

Yes, this skill requires the GitHub (gh) CLI to be installed and authenticated to fetch PR metadata and file diffs.

How does it handle projects with many modules?

It groups changed files by their respective modules and provides a concise list of specifications relevant to each module specifically, avoiding information overload.

Pull Request Review Context

Name: Pull Request Review Context
Author: alexnodeland

byalexnodeland

•

协作工具

Surfaces relevant proposals, plans, and architectural decisions to provide deep context for GitHub pull request reviews.

The review-context skill automates the process of gathering background information for code reviews by mapping changed files to project modules and identifying related specifications. It scans for RFCs, active development plans, and Architectural Decision Records (ADRs) mentioned in PR descriptions or stored within specific documentation directories. By providing a structured summary of the technical rationale behind code changes, it helps reviewers ensure alignment with long-term project goals and technical decisions without requiring manual document searches.

主要功能

01Maps changed files to specific project modules via CLAUDE.md discovery

02Searches module-level documentation for active implementation plans

03Parses PR descriptions for explicit plan and proposal references

043 GitHub stars

05Identifies relevant Architecture Decision Records (ADRs) and RFCs

06Generates a structured context summary directly in the terminal

使用场景

01Onboarding a reviewer to a complex set of changes spanning multiple modules

02Verifying that a PR aligns with the specific tasks outlined in a design proposal or RFC

03Ensuring new code changes comply with previously agreed-upon ADRs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled review-context

For use in Claude.ai and ChatGPT

Download Skill