Skip to content

PR Report Writer

Turns a code pull request into a maintainer-style HTML or Markdown review report

Stars
110,078
Licence
MIT
Files
3 files

What it does

When installed, the agent can take a pull request, branch, or large code contribution and produce a structured review report. The report explains what the change adds, how the system works, the risks and strengths it finds, how it compares to similar projects, and a clear merge recommendation. It can output a standalone HTML webpage or a Markdown file, using bundled style guidance and an HTML starter template.

Great for

  • Open-source maintainers who need to evaluate a large or complex pull request
  • Engineers who want a readable walkthrough of an unfamiliar contribution before reviewing it
  • Teams preparing a merge, redesign, or scope decision for a significant feature

Skip it if

  • Quick typo or small bug-fix reviews, since the workflow is designed for deep, multi-section reports and would be overkill
  • Anyone expecting it to actually run or test the code; the SKILL.md asks for verification but does not itself include test execution scripts, and reports should be checked against the real code before acting on them

Try asking

  • “Review this PR deeply and tell me where the risks are”
  • “Explain this contribution to me as an HTML report I can share with the team”
  • “Compare this plugin design to similar open-source systems and recommend whether to merge”
  • “Should I merge this branch? Give me a Markdown report with a clear recommendation”
Step-by-step guide: how to use PR Report WriterInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 3 original files, the MIT licence and an attribution note.

    pr-report.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip pr-report.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip pr-report.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at a local checkout or branch so it can read the actual code rather than relying only on the GitHub PR page
  • Ask for a specific output format (HTML or Markdown) and a folder location if you have a preference
  • Treat the recommendation as a starting point and spot-check the cited file references before making a decision

What's inside

  • assets/html-report-starter.html
  • references/style-guide.md
  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.