github-activity-report

Generates GitHub activity reports by crawling per-repo pulls and commits endpoints via the gh CLI.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Claudfather/clauDNA --skill github-activity-report-claudfather
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-activity-report
Source: https://github.com/Claudfather/clauDNA/tree/main/skills/github-activity-report
Command: npx skills add https://github.com/Claudfather/clauDNA --skill github-activity-report-claudfather

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, and includes scripts (resource) components.

What problem does it solve? The GitHub search API silently truncates results at 1,000 entries, so author and repo breakdowns derived from it are biased and incomplete. This Skill produces accurate organization-wide or personal GitHub activity statistics by iterating each repository's pulls and commits endpoints directly, which have no such cap. ## Core Features & Use Cases - Per-repo crawling: A bundled crawl.sh script pages through every repo's PRs and commits within a chosen date window, writing JSONL data for further slicing. - Ranked statistics: Produces top PR authors, top commit authors, full long-tail repo rankings by PR and commit volume, and repo-by-author cross-tabulations. - Concentration insights: Identifies solo-driven repos (>80% single-author), lead-with-team patterns, and where top contributors are absent. - Use Case: An engineering manager wants to know who the top contributors are across a 200-repo org over the last 6 months. The Skill lists repos, crawls them in the background with progress monitoring, and writes a markdown report to ~/Downloads/. ## Quick Start Ask the assistant to generate a GitHub activity report for your organization or personal account over the last six months, then pick a scope from the menu it presents.

Frequently Asked Questions about github-activity-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get GitHub activity stats for an entire organization?

Use the gh CLI to list all non-archived org repos via GraphQL with pagination, then iterate each repo's pulls and commits endpoints for the chosen date window. Aggregate the JSONL output with jq to rank authors and repos.

Why are GitHub search API author breakdowns inaccurate?

The search API paginates only the first 1,000 results even when total_count is higher, so per-author and per-repo splits are biased toward GitHub's sort order. Crawling each repo's pulls and commits endpoints directly avoids this cap entirely.

Does this work for personal GitHub accounts as well as orgs?

Yes. The scope picker lists all orgs you belong to plus your personal account. For personal scope it queries viewer repositories with OWNER affiliation, excluding forks and archived repos.

How long does a GitHub activity crawl take?

Crawls typically take 5 to 20 minutes depending on org size, since each repo requires paged calls to two endpoints. The script runs in the background and logs per-repo progress that can be monitored every 30 seconds.

Why doesn't the report include lines-of-code statistics?

LOC stats require one API call per commit to fetch additions and deletions, which means thousands of requests for an active org and triggers secondary rate limits. They are only attempted if explicitly requested.

How are bot accounts like dependabot handled in the rankings?

Bot accounts such as dependabot[bot] are included in the raw rankings and can dominate them. The report flags this in its caveats section, and the raw JSONL data can be re-filtered to produce a humans-only view.