pr-report

Generate maintainer-grade PR review reports as standalone HTML or Markdown documents.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/adamtpang/summon.company --skill pr-report-adamtpang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-report
Source: https://github.com/adamtpang/summon.company/tree/main/.agents/skills/pr-report
Command: npx skills add https://github.com/adamtpang/summon.company --skill pr-report-adamtpang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Deeply reviewing a large pull request or contribution requires understanding the whole system, not just the diff, and turning that analysis into a clear, actionable report is time-consuming and inconsistent. ## Core Features & Use Cases - Maintainer-Grade Review Workflow: Reconstructs the system design behind a PR, orders findings by severity, cites concrete file references, and separates architectural objections from product-scope concerns. - Polished Report Artifacts: Produces standalone HTML reports using a bundled starter template and editorial style guide, or Markdown reports, with sections for summary, tutorial, findings, comparisons, and recommendation. - Actionable Recommendations: Ends every review with a concrete call such as merge as-is, merge after redesign, salvage specific pieces, or keep as design research. - Use Case: A maintainer facing a 5,000-line plugin-system PR asks for a deep review and receives a navigable HTML report explaining the architecture, listing severity-ranked findings with file references, comparing the design to similar open-source systems, and recommending which parts to keep. ## Quick Start Review the current branch as a PR and produce a standalone HTML report with findings and a merge recommendation in tmp/reports.

Frequently Asked Questions about pr-report

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

FAQPage Schema
How do I get a deep review of a large pull request?

Ask for a deep review of the target branch or PR. The workflow reconstructs the system design from local code, ranks findings by severity with concrete file references, and ends with a specific merge recommendation rather than a vague impression.

How to generate an HTML report for a GitHub PR review?

Request a webpage or HTML report for the PR. The output is a standalone HTML artifact built from a bundled starter template and style guide, with a sticky navigation, executive summary, findings, and recommendation sections.

What output formats does the PR review report support?

Reports can be produced as standalone HTML files in tmp/reports, Markdown files in a report folder, or a short maintainer summary directly in chat. The format is chosen based on what you ask for.

Can the review compare a PR design to other open-source systems?

Yes. When a contribution introduces a framework or platform concept, the review compares it to similar open-source systems using official docs or source, focusing on lifecycle ownership, trust model, context passing, and extension boundaries.

When should I not rely on this PR review approach?

The review works from local code and documented intent, so it is weaker when contributor intent is undocumented or tests cannot be run. In those cases the report explicitly states that verification or tests were skipped.