claude-review-metrics

A Claude Code plugin that analyzes GitHub PR review activity, team performance rankings, and review bottlenecks.

Installation

claude plugin add b4tchkn/claude-review-metrics

Usage

/review-metrics                              # All rankings (current week)
/review-metrics last-week                    # All rankings (previous week)
/review-metrics month comments               # Comment ranking (last 30 days)
/review-metrics last-week response-time      # Response time ranking
/review-metrics bottleneck                   # PR lifecycle bottleneck analysis
/review-metrics stuck                        # Currently stuck PRs
/review-metrics last-week reviewer-load      # Team review workload
/review-metrics last-week cycles             # Review round patterns
/review-metrics month pr-size                # PR size vs review speed

Features

Rankings (Top 3)

Command	Description
comments	Review comment count
reviewed	Reviewed PR count
approved	Approval count
response-time	Avg time from review request to first review
fix-time	Avg time from review comment to next commit (capped at 2 weeks)

Analysis (Team-wide)

Command	Description
bottleneck	PR lifecycle phase breakdown (wait/review/merge) with Avg, p50, p90 and actionable suggestions
stuck	Open PRs needing immediate attention (ignores period, always shows current state)
reviewer-load	Team review workload distribution with load balance warnings
cycles	Review round counts, change-request patterns, and high-cycle PR detection
pr-size	PR size (XS/S/M/L/XL) vs review speed correlation

Period Options

Period	Description
week	Current week (Mon-Fri) - default
last-week	Previous week (Mon-Fri)
month	Last 30 days

How It Works

Data Collection

• Rankings use GitHub GraphQL API to fetch merged PR review data with automatic pagination
• Analysis scripts use an extended GraphQL query for full PR lifecycle data (timeline events, review requests, commits)
• Fix Time ranking uses GitHub REST API (2-3 calls per PR) to correlate review comments with subsequent commits
• Stuck PRs queries only open PRs, independent of period

Metrics Definitions

Metric	Definition
Response Time	Time from ReviewRequestedEvent to first PullRequestReview by that reviewer
Fix Time	Time from review comment to next commit (capped at 336 hours / 2 weeks)
Wait for Review	Time from PR creation (or ReadyForReviewEvent) to first review
Review Cycles	Time from first review to last approval
Merge Delay	Time from last approval to merge
Review Rounds	changes_requested_count + 1 (if approved)
PR Size	Total changed lines: XS (1-10), S (11-50), M (51-200), L (201-500), XL (500+)

Bot Filtering

Create a .review-metrics-exclude file in your repository root to exclude bot accounts from all metrics. If the file does not exist, no accounts are excluded.

# .review-metrics-exclude
github-actions
renovate[bot]
dependabot[bot]

Format: one account per line. Lines starting with # are comments.

Requirements

• GitHub CLI (gh) installed and authenticated
• jq for JSON processing
• bash, awk (standard Unix tools)
• macOS and Linux supported

Development

Project Structure