github-contributions

GitHub Contributions Skill

Generate contribution summaries across all active repositories in a GitHub organization, grouped by contributor.

What This Does

1. Queries a GitHub organization for repositories with activity within a configurable time period
2. For each active repository, collects pull requests and commit history
3. Associates commits with their pull requests and groups by author
4. Gathers: commit messages, files changed, lines added/removed (no diffs)
5. Supports attribution override: if a PR description contains Requested by @USER in #CHANNEL., all commits in that PR are attributed to the mentioned user instead of the PR author
6. Produces a structured per-contributor summary with PR breakdowns across all repositories

Parameters

Parameter	Default	Description
ORG	(required)	GitHub organization name
TIME_PERIOD	7	Number of days to look back
GITHUB_TOKEN	(from env)	GitHub personal access token (uses gh auth if not set)
--output / -o	(stdout)	Write JSON to a file instead of stdout
--quiet / -q	false	Suppress progress messages on stderr

Usage

Quick Run (Agent)

When the user asks for a contribution report:

1. Determine the organization name (ask if not provided)
2. Determine time period (default: 7 days)
3. Run the collection script:

   python3 <skill_dir>/scripts/collect_contributions.py --org <ORG> --days <TIME_PERIOD> -o /tmp/contributions.json
   

4. The script writes JSON to the output file (or stdout if -o is omitted). Parse and format the report.
5. Format the output using the template below.

Manual Run

# Using gh CLI token — write to file to keep output clean
export GITHUB_TOKEN=$(gh auth token)
python3 scripts/collect_contributions.py --org difflabai --days 7 -o /tmp/contributions.json

# Or pipe to stdout (progress goes to stderr)
python3 scripts/collect_contributions.py --org difflabai --days 7 -q

Attribution Override

If a PR description contains the pattern:

Requested by @USERNAME in #CHANNEL.

All commits in that PR are attributed to @USERNAME instead of the PR's author. This is useful when an automated tool or bot creates PRs on behalf of a team member.

Output Format

Structure the report as follows:

# Team Contributions Report
**Organization:** {org}
**Period:** {start_date} → {end_date}

## Repository Activity

### {repo_name}
- [PR #{number}]({url}): {title} — @{author}
- [PR #{number}]({url}): {title} — @{author} *(attributed to @{attributed_to})*

---

## {Contributor Name} (@{username})

**Summary:** {total_commits} commits across {repo_count} repositories | +{lines_added} / -{lines_removed}

### {repo_name}
- **Commits:** {count}
- **Files changed:** {count}
- **Lines:** +{added} / -{removed}

#### [PR #{number}]({url}): {title}
- **Lines:** +{added} / -{removed}
- **Commits:**
  - {commit_message_1}
  - {commit_message_2}

#### Direct commits (no PR)
- {commit_message_1}
- {commit_message_2}

---
## Organization Totals

| Contributor | Commits | Repos | Lines Added | Lines Removed |
|-------------|---------|-------|-------------|---------------|
| @{user1}    | {n}     | {n}   | +{n}        | -{n}          |
| ...         |         |       |             |               |
| **Total**   | **{n}** |**{n}**| **+{n}**    | **-{n}**      |

Scripts

scripts/collect_contributions.py

Main collection script. Queries the GitHub API for:

1. All repositories in the organization
2. Filters to repos with commits in the time period
3. Fetches pull requests with activity in the time period
4. Associates commits with their PRs
5. Applies attribution override from PR descriptions (Requested by @USER in #CHANNEL.)
6. Collects commit details per author per repo, grouped by PR

Outputs structured JSON to stdout for agent consumption.

scripts/format_report.py

Optional formatting script. Takes the JSON output from collect_contributions.py and produces a markdown report.

python3 scripts/collect_contributions.py --org difflabai --days 7 | python3 scripts/format_report.py

Notes

• Uses GitHub REST API (not GraphQL) for broad compatibility
• Respects rate limits with automatic retry on 403/429
• Merge commits are excluded by default (use --include-merges to include)
• Bot accounts are excluded by default (login or name ending in [bot], plus known bots like dependabot, copilot, renovate)
• If GITHUB_TOKEN is not set, attempts to use gh auth token
• Performance: Fetching commit details requires one API call per commit (N+1). For very large or active organizations this may be slow and could hit rate limits despite automatic back-off. Consider using a shorter --days window for large orgs