pr-review-navigator

Generate dependency-aware review paths for GitHub pull requests with mermaid flowcharts and tables.

154|28|Updated Aug 31, 2018
One-click install
npx skills add https://github.com/commercetools/ui-kit --skill pr-review-navigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-review-navigator
Source: https://github.com/commercetools/ui-kit/tree/main/.agents/skills/pr-review-navigator
Command: npx skills add https://github.com/commercetools/ui-kit --skill pr-review-navigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces the time and friction for a human reviewer to get oriented on a pull request by extracting changed files, diffs, additions/deletions, and inter-file dependencies and presenting them as a structured review plan.

Core Features & Use Cases

  • Orientation Summary: Produces a concise factual summary of what changed and how many lines/files were affected.
  • Dependency-aware Review Order: Analyzes imports/references to suggest an outside-in review order (API → service → persistence → models → tests).
  • Visual & Tabular Guidance: Emits a mermaid flowchart of file relationships and a numbered review table with SHA256-based GitHub file links; can post as a PR comment or write to a local markdown file.

Quick Start

Run the skill with the PR number to generate a mermaid diagram and ordered review table and save it locally or post it as a PR comment.

Frequently Asked Questions about pr-review-navigator

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

FAQPage Schema
How do I create an ordered review plan for a GitHub pull request?

To create an ordered review plan for a GitHub pull request, you can generate AI-assisted navigational guidance that analyzes changed files and dependency relationships to recommend a structured review path. This produces a numbered table and mermaid flowchart.

How does dependency-aware diff analysis work for code reviews?

Dependency-aware diff analysis works by examining imports and references across changed files to suggest an outside-in review order, such as API → service → persistence → models → tests. This helps reviewers understand structural relationships and impact before reading code.

Can I post a mermaid flowchart and review summary directly as a PR comment?

Yes, you can post a mermaid flowchart and review summary directly as a PR comment. The generated output includes a visual file relationship diagram and a numbered review table with SHA256-based GitHub file links that can be published to the pull request.

What is the best way to navigate large pull request diffs efficiently?

The best way to navigate large pull request diffs efficiently is to use AI guidance that extracts additions, deletions, and inter-file dependencies to produce an orientation summary. This reduces time and friction by highlighting what changed and recommending a review order.

Does this code review guidance work without external dependencies?

Yes, this code review guidance works without external dependencies. It operates independently to analyze GitHub pull requests and diffs, requiring only the PR number to generate navigational guidance, mermaid diagrams, and structured markdown tables.