skills.rest
scottopell
scottopellCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

coaching-pr-review

Analyze GitHub PRs and produce structured markdown reviews with coaching notes.

1|Updated May 22, 2013
Search Tags:#github#coaching#code-review#design-review#pr-review#diff-analysis#manager-lens
One-click install
npx skills add https://github.com/scottopell/dotfiles --skill coaching-pr-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coaching-pr-review
Source: https://github.com/scottopell/dotfiles/tree/main/home-dir-configs/claude/skills/coaching-pr-review
Command: npx skills add https://github.com/scottopell/dotfiles --skill coaching-pr-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PRs often hide design flaws and operational risks behind code changes. This skill provides a manager-focused lens to assess design quality, maturity, and coaching opportunities, going beyond the PR description to understand the real impact.

Core Features & Use Cases

  • Manager-level PR critique focusing on design quality, operational maturity, and growth signals.
  • Reveal alignment or misalignment between what the PR claims and what the diff actually changes; surface risks and opportunities for mentorship.
  • Use when asked to review a PR, when you paste a GitHub PR URL or number with repo context, or when you want a structured evaluation of a code change from a managerial perspective.

Quick Start

Provide a GitHub PR URL or PR number (with repo context) and ask for a manager-focused PR review.

Frequently Asked Questions about coaching-pr-review

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

FAQPage Schema
How do I review a GitHub PR from a manager's perspective?▼

To review a GitHub PR from a managerial perspective, analyze the diff to assess design quality, operational maturity, and coaching opportunities rather than just surface-level code changes. This approach reveals alignment between stated intent and actual impact.

What is a manager-focused code review?▼

A manager-focused code review evaluates design quality, operational risks, and growth signals in a pull request. It goes beyond the PR description to compare stated intent with actual changes, surfacing mentorship opportunities and hidden design flaws.

How do I get a structured PR review with coaching notes?▼

Provide a GitHub PR URL or PR number with repo context to generate a structured markdown review. The output includes sections for problem statement, design review, stats, operational concerns, correctness, and coaching notes.

Do I need the gh CLI to analyze a GitHub PR diff?▼

Yes, fetching PR metadata and the actual diff requires using the gh CLI. This allows the review process to compare the stated intent with the changes by accessing the repository context directly.

What does a design review of a PR reveal?▼

A design review of a PR reveals misalignment between what the PR claims and what the diff actually changes. It surfaces architectural risks, operational maturity, and specific opportunities for developer mentorship and coaching.

Can I use a PR URL to evaluate operational maturity and risks?▼

Yes, you can paste a GitHub PR URL to evaluate operational maturity and risks. The analysis fetches the diff via gh and produces a structured review highlighting operational concerns and correctness alongside coaching notes.

Related Skills

Explore More Software Engineering Skills→
shenxingyshenxingy
8

review-pr

Review GitHub pull requests and post structured comments with merge verdicts.

Community
Intermediate
elihuvillarauselihuvillaraus
2

sales-coach

Analyze rep performance and call recordings to generate coaching plans.

Community
Advanced
cloud-native-toolscloud-native-tools

code-review

Standardize code reviews with git-delta diff visualization and structured feedback.

Official
Advanced
winsorllcwinsorllc

code-review

Execute linters, static analysis, and security scanners on code.

Community
Intermediate