review-pr

Generates a Mermaid flow diagram, outcomes table, and reading map from a GitHub pull request.

5|Updated Sep 9, 2017
One-click install
npx skills add https://github.com/hpcsc/dotfiles --skill review-pr-hpcsc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/hpcsc/dotfiles/tree/main/link/common/dot-config/.config/opencode/skills/review-pr
Command: npx skills add https://github.com/hpcsc/dotfiles --skill review-pr-hpcsc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large pull requests are hard to understand from a diff alone, because hunks show what moved but never what the code decides. This Skill reads a PR's whole files and produces a compact model of the change so a reviewer can hold it in their head without sorting through findings. ## Core Features & Use Cases - Flow diagram: Builds a 10-15 node Mermaid diagram of the path through the system, marking what the change adds with NEW, and renders it to SVG via mermaid-cli. - Outcomes table: Lists one row per observable case, before and after, including unchanged cases and irreversible outcomes. - Reviewer map: Maps each reviewer question to the file that answers it, with a suggested reading order and production/test size counts. - Use Case: You are assigned a 40-file PR and cannot follow it from the diff. Run this Skill to get the flow, the observable behavior changes, and exactly which files to read in what order. ## Quick Start Ask the assistant to review PR #123 and produce the flow diagram, outcomes table, and reading map.

Frequently Asked Questions about review-pr

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

FAQPage Schema
How do I understand a large pull request that is too big for its diff?▼

Fetch the PR with gh pr view and gh pr diff, then read whole files wherever a hunk changes a decision such as a condition or branch. Summarize the change as a flow diagram, an outcomes table, and a map from reviewer questions to the files that answer them.

How to generate a Mermaid diagram of code changes in a PR?▼

Build a 10-15 node Mermaid diagram naming nodes as the system names them, put conditions on edges, and mark additions with NEW. Render it with mmdc from @mermaid-js/mermaid-cli to produce an SVG before printing the source.

Does this PR review approach report code defects or findings?▼

No, it deliberately reports no findings and posts nothing. Its deliverable is understanding only; defect critique is left to a separate code-review pass, CI checks, and human judgment.

Can I save the PR review brief to a file?▼

Yes, pass --save to write the brief to .pr-notes/pr-<N>.md and automatically add that path to .git/info/exclude. Without the flag, the brief exists only in the chat.

What tools are required to fetch and review a GitHub pull request?▼

The workflow requires the GitHub CLI (gh) to fetch PR metadata, diffs, and commit lists, and mermaid-cli (mmdc) to render diagrams. Both are invoked through standard shell commands.