pr-report

Analyze pull requests and generate maintainer-grade HTML or Markdown reports.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/VitorRibeiro45/paperclip --skill pr-report-vitorribeiro45
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-report
Source: https://github.com/VitorRibeiro45/paperclip/tree/main/.agents/skills/pr-report
Command: npx skills add https://github.com/VitorRibeiro45/paperclip --skill pr-report-vitorribeiro45

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep PR reviews often require time to unpack design decisions, trade-offs, and implementation intent. This skill analyzes a pull request or large contribution and outputs a polished maintainer-ready report (HTML or Markdown) that communicates structure, rationale, and recommended next steps.

Core Features & Use Cases

  • Tutorial-style explanations of changes and architectural decisions to help maintainers understand the code beyond the diff.
  • Output artifacts including standalone HTML reports or Markdown documents suitable for documentation or decision papers.
  • References and guidance provided by bundled resources (such as style guides) to ensure consistent presentation and risk-aware assessments.
  • Use Cases: when asked to analyze a PR, compare it with similar systems, or generate a merge recommendation for a branch or contribution.

Quick Start

Provide the target PR and request a maintainer-grade HTML or Markdown report.

Frequently Asked Questions about pr-report

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

FAQPage Schema
How do I generate a maintainer-grade PR review report?

To generate a maintainer-grade PR review report, you provide the target pull request and request an analysis. The skill evaluates the code changes, compares them with similar approaches, and outputs a structured HTML or Markdown artifact communicating design rationale and recommendations.

Can I output a pull request analysis as an HTML document?

Yes, you can output a pull request analysis as a standalone HTML document. The skill uses a bundled HTML starter to structure the report, ensuring the final artifact is polished and ready to share with project maintainers or stakeholders.

What is included in an AI-assisted code review report?

An AI-assisted code review report includes tutorial-style explanations of changes, architectural context, and trade-off analysis. It frames the pull request within the broader system design and provides recommended next steps for maintainers to act upon.

Does this PR review skill work with Markdown for documentation?

Yes, this PR review skill supports Markdown output for documentation. It can generate Markdown documents suitable for decision papers or internal documentation, using bundled style guidance to ensure consistent presentation and risk-aware assessments.

What is the best way to communicate architectural decisions in a pull request?

The best way to communicate architectural decisions in a pull request is to generate a structured report artifact. This approach unpacks design decisions and implementation intent, providing maintainers with context beyond the raw diff to understand the code deeply.

When should I use an automated PR review report over a manual diff check?

You should use an automated PR review report when you need to deeply analyze design decisions, trade-offs, and implementation intent for large contributions. It is ideal when you require a merge recommendation or a ready-to-share artifact for decision papers.