Does this skill require the GitHub CLI?

Yes, the skill requires the GitHub (gh) CLI to be installed and authenticated to fetch PR data and post summary comments.

How does it link reviews to specifications?

It parses review checklists and comments, then maps them to specification items or ADRs based on the context found in the PR and repository documentation.

What metrics does the review summary provide?

It calculates coverage percentages for acceptance criteria, ADR compliance, and general quality checklists to show how much of the spec has been addressed.

Can I use this skill without posting to GitHub?

Yes, using the --local-only flag will generate the summary and save it to the .review/ directory without posting it as a public PR comment.

Can I customize the summary report format?

Yes, the skill uses a template located at templates/review-summary.md which can be modified to fit your team's specific reporting standards.

Review Summary

Name: Review Summary
Author: alexnodeland

byalexnodeland

•

Collaboration Tools

Generates structured, specification-linked pull request summaries with coverage metrics and findings tables.

The Review Summary skill automates the creation of comprehensive PR reports by aggregating review comments, checklist statuses, and metadata directly from GitHub. It bridges the gap between implementation and requirements by mapping findings to specific items in your project's specification or Architecture Decision Records (ADRs). This skill is essential for teams following specification-driven development who need to track review coverage, manage unresolved issues, and maintain a clear audit trail of the review process both on GitHub and in local documentation.

Key Features

01Automated PR metadata and comment collection via GitHub CLI

02Local storage and GitHub comment synchronization with template support

03Detailed coverage metrics for acceptance criteria and ADR compliance

04Automatic identification of unresolved comments and blocking issues

05Structured findings table with severity levels and specification mapping

063 GitHub stars

Use Cases

01Generating a standardized review report for hand-offs or release documentation

02Summarizing complex PRs with high comment volume to identify remaining blockers

03Auditing PR compliance against project specifications and architecture decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled review-summary

For use in Claude.ai and ChatGPT

Download Skill