mcpField
G
github-contribution-period-analysis

github-contribution-period-analysis

github.com/tiangong-aiData & databases1141 installsUpdated 1w ago
Repository

About github-contribution-period-analysis

GitHub Contribution Period Analysis is a skill that creates an evidence-based Markdown report of a GitHub user's contributions within a UTC time window. It covers authored or merged pull requests and authored commits, with coverage constrained by API credentials.

Key features

  1. 01Analyzes contributions within a UTC time window
  2. 02Includes authored and merged pull requests
  3. 03Includes commits authored by the target user
  4. 04Produces metrics, repository breakdowns, and timelines
  5. 05Provides evidence links for changes

Use cases

  1. 01Review a user's code contributions over a defined period
  2. 02Compare contribution activity across repositories
  3. 03Prepare a report with links to PR and commit evidence

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tiangong-ai/agent-skills --skill github-contribution-period-analysis

After installing, type/github-contribution-period-analysisin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
data-model.md
env.md
markdown-template.md
scripts/
github_contribution_report.py

Details

From the project README

GitHub Contribution Period Analysis

Core Goal

  • Build an evidence-based Markdown report for one target GitHub user in a UTC time window.
  • Focus on practical code contribution signals: merged PR and commit activity.
  • Cover both own repositories and other repositories, limited by credential access.

Workflow

  1. Prepare authentication for GitHub API access.
  2. Run scripts/github_contribution_report.py with target user and time window.
  3. Review the generated Markdown report and inspect evidence links.

Command

python3 scripts/github_contribution_report.py \
  --user <github-login> \
  --start 2026-03-01 \
  --end 2026-03-08 \
  --output /tmp/github-contribution-report.md

Output Semantics

  • Included contribution types:
    • Authored merged PRs.
    • PRs merged by the target user (maintainer merge work).
    • Authored commits.
  • Excluded activity types:
    • Comments, reviews, stars, watches, forks.
  • The report contains:
    • Scope and coverage notes.
    • Summary metrics.
    • Substantive work categories inferred from PR/commit evidence.
    • Work content highlights with representative evidence links.
    • Repository breakdown.
    • Per-repository concrete change details (for every changed repository).
    • Contribution timeline.
    • Top contribution tables.
    • Evidence appendix with PR/commit URLs.

Important Constraints

  • SSH key alone is for git transport and does not directly authorize GitHub REST API calls.
  • Private repository coverage needs authenticated API access, typically via GITHUB_TOKEN/GH_TOKEN or gh auth token.
  • GitHub Search API has a 1000-item cap per query. For very active users, split the time range and run multiple reports.

References

  • references/env.md
  • references/data-model.md
  • references/markdown-template.md

Scripts

  • scripts/github_contribution_report.py

Comments

Markdown supported