Agent-Skills.md

Agent Skills: GitHub Insights Skill

|

UncategorizedID: kwiggen/claude-code-plugin/github-insights

Repository

kwiggen/claude-code-plugin
kwiggenLicense: MIT
1

Skill Files

Browse the full folder contents for github-insights.

Download Skill

Loading file tree…

skills/github-insights/SKILL.md

Skill Metadata

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 gh CLI authenticated (gh auth status)