github-insights
Provides team GitHub activity insights including merged PRs, contributorleaderboards, merge velocity, review participation, and PR size analysis.Use when users ask about team productivity, who merged PRs, code contributionstats, review patterns, or developer activity.
When & Why to Use This Skill
The GitHub Insights skill provides comprehensive analytics and data-driven visibility into team productivity and repository health. By analyzing merged pull requests, contributor leaderboards, and review patterns, it helps engineering managers and developers identify workflow bottlenecks, optimize merge velocity, and ensure high-quality code review standards through automated markdown reporting.
Use Cases
- Team Productivity Tracking: Generate contributor leaderboards and activity summaries to monitor output and recognize top performers during sprint reviews.
- Workflow Bottleneck Identification: Analyze 'time-to-merge' and PR size distribution to pinpoint stages where the development process slows down.
- Code Review Quality Audit: Evaluate review depth and feedback cycles to detect 'rubber stamping' and ensure thorough peer evaluations.
- Workload Balancing: Use the 'review-balance' ratio to ensure code review responsibilities are distributed fairly across the team, preventing developer burnout.
- Stability & Risk Assessment: Track reverts and hotfixes to gain insights into codebase stability and the impact of recent deployments.
| name | github-insights |
|---|---|
| description | | |
GitHub Insights Skill
Analyze team GitHub activity for the current repository.
Available Actions
| Action | Description |
|---|---|
prs-merged |
List all PRs merged in a time period |
leaderboard |
Rank contributors by PR count and lines changed |
activity |
Summary stats + leaderboard + day/hour breakdown |
time-to-merge |
Merge velocity per developer (avg/median) |
reviews |
Who reviews whose code |
pr-size |
Size distribution and bottleneck detection |
first-review |
Time to first review per developer |
review-balance |
Reviews given vs received ratio |
reverts |
Track reverts and hotfixes |
review-depth |
Detect rubber stamp reviews |
review-cycles |
Rounds of feedback before merge |
all |
Run all reports with visual separators |
Usage
Run the script from the skill's scripts directory:
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action <ACTION> [OPTIONS]
Options
--action(required): One of the actions above--days N: Look back N days (default: 30)--start YYYY-MM-DD: Start date for custom range--no-stats: Skip line count fetching (faster for large repos)
Examples
# PRs merged in last 30 days
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action prs-merged
# Leaderboard for last week
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action leaderboard --days 7
# Time to merge analysis
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action time-to-merge --days 30
# Review participation
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action reviews --days 30
# PR size analysis with bottleneck detection
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action pr-size --days 30
# Time to first review
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action first-review --days 30
# Review balance (given vs received)
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action review-balance --days 30
# Reverts and hotfixes tracking
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action reverts --days 30
# Rubber stamp detection
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action review-depth --days 30
# Review cycles (rounds of feedback)
python {baseDir}/skills/github-insights/scripts/gh_stats.py --action review-cycles --days 30
Interpreting User Requests
| User Says | Action | Options |
|---|---|---|
| "show PRs merged" | prs-merged |
default 30 days |
| "who merged the most PRs" | leaderboard |
- |
| "team activity last week" | activity |
--days 7 |
| "how long do PRs take to merge" | time-to-merge |
- |
| "who is reviewing code" | reviews |
- |
| "are big PRs slowing us down" | pr-size |
- |
| "PR bottlenecks" | pr-size |
- |
| "how long until first review" | first-review |
- |
| "is review load balanced" | review-balance |
- |
| "any reverts or hotfixes" | reverts |
- |
| "are reviews thorough" | review-depth |
- |
| "rubber stamp reviews" | review-depth |
- |
| "how many review rounds" | review-cycles |
- |
| "run all reports" | all |
- |
| "full team analysis" | all |
- |
Output
The script outputs markdown tables ready for display. No additional formatting needed.
Prerequisites
- Must be run from within a git repository
- Requires
ghCLI authenticated (gh auth status)