pr-report

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Deeply reviewing a large PR 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 design behind a change, orders findings by severity, and separates architectural objections from product-scope concerns. - Polished Report Artifacts: Produces standalone HTML reports using a bundled style guide and HTML starter template, or Markdown reports for documentation folders. - 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 webpage; the skill analyzes the branch, compares the design to similar open-source systems, and delivers a navigable HTML report with findings and a merge recommendation. ## Quick Start Review the current PR branch deeply and build me a polished HTML report with findings and a merge recommendation.

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 PR?

Ask for a deep review of the target branch or PR and the skill works from local code rather than just the GitHub page. It reconstructs the system design, lists findings by severity with file references, and ends with a concrete merge recommendation.

How to generate an HTML report for a pull request?

Request a webpage or HTML report for the PR and the skill builds a standalone HTML artifact, typically starting from the bundled html-report-starter.html template. It follows the bundled style guide for typography, layout, and color so the report reads like an editorial review.

What output formats does the PR report support?

The skill produces standalone HTML reports in a tmp/reports folder, Markdown reports in a report folder or another requested location, and a short maintainer summary directly in chat. The chat summary stays shorter than the full report.

Can the review compare a 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. Comparisons focus on extension boundaries, context passing, trust models, and UI ownership.

What kinds of issues does the PR review prioritize?

Findings are ordered by severity, prioritizing behavioral regressions, trust or security gaps, misleading abstractions, lifecycle and operational risks, hard-to-unwind coupling, and missing tests. Each finding cites concrete file references where possible.

When should I not use a full PR report workflow?

The full workflow is designed for large or architecturally significant contributions where a maintainer-grade judgment is needed. For small typo fixes or trivial diffs, a lightweight inline review is more appropriate than building a structured report artifact.