gh-summary

GitHub Contribution Summary

Summarize merged PRs and interpret the business/engineering value delivered.

Usage

• /gh-summary - Current repo, last 30 days
• /gh-summary last 7 days - Current repo, last 7 days
• /gh-summary since January 1st - Current repo, since date
• /gh-summary owner/repo1 owner/repo2 last 30 days - Multiple repos

Arguments

Arguments can be provided in any order. The skill will parse:

1. Repos (optional): Comma or space-separated list of repos in owner/repo format

   • If omitted, uses the current working directory's repo
   • Examples: owner/repo-name, owner/repo1,owner/repo2

2. Time range (optional): Natural language time specification

   • Relative: "last 7 days", "last 2 weeks", "last 30 days"
   • Absolute: "since January 1st", "since 2026-01-01"
   • If omitted, defaults to "last 30 days"

Process

Step 1: Parse Arguments

Parse the ARGUMENTS string to extract:

• repos: List of repos, or empty (meaning current repo)
• time_range: Natural language time, or "last 30 days" default

Convert time range to ISO date format (YYYY-MM-DD) for the gh search query.

Step 2: Get GitHub Username

gh api user --jq '.login'

Step 3: Fetch PRs for Each Repo

For each repo (or current repo if none specified):

gh pr list --repo {repo} --author {username} --state merged \
  --search "merged:>={iso_date}" --limit 200 \
  --json number,title,body,mergedAt,additions,deletions,changedFiles,commits,url

If no --repo flag needed (current repo), omit it:

gh pr list --author {username} --state merged \
  --search "merged:>={iso_date}" --limit 200 \
  --json number,title,body,mergedAt,additions,deletions,changedFiles,commits,url

Step 4: Calculate Stats

From the PR data, calculate:

• PR count: Total number of PRs merged
• Lines added: Sum of additions across all PRs
• Lines removed: Sum of deletions across all PRs
• Net lines: additions - deletions
• Files changed: Sum of changedFiles across all PRs
• Commits: Sum of commit counts (length of commits array) across all PRs
• Repos touched: Count of unique repos (if multi-repo)