gh-activity-summary

Summarize GitHub activity into a plain-language report for a date range.

38|5|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/ericmjl/skills --skill gh-activity-summary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-activity-summary
Source: https://github.com/ericmjl/skills/tree/main/skills/gh-activity-summary
Command: npx skills add https://github.com/ericmjl/skills --skill gh-activity-summary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates a plain-language report of GitHub activity over a specified date range, including commits, PRs, reviews, issues, and comments.

Core Features & Use Cases

  • Provides a readable overview of authored commits, created/merged PRs, reviews, and issues for status updates, retrospectives, or project tracking.
  • Supports date-range filtering and natural-language formatting suitable for sharing with non-technical stakeholders.
  • Use case: generate a concise activity summary for a team standup or dashboard.

Quick Start

Run the activity-report.sh script with optional START_DATE and END_DATE in YYYY-MM-DD format to generate the report.

Frequently Asked Questions about gh-activity-summary

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

FAQPage Schema
How do I generate a plain-language GitHub activity report for a specific date range?

To generate a GitHub activity report, run the activity-report.sh script with START_DATE and END_DATE in YYYY-MM-DD format. It summarizes commits, PRs, reviews, issues, and comments into a readable plain-language output.

Can I use GitHub CLI to summarize commits and pull requests for a team standup?

Yes, you can use GitHub CLI to summarize commits and pull requests for standups. This script processes authenticated gh CLI data via jq to format authored commits, created PRs, and reviews into a concise activity overview.

What is the best way to track GitHub code review and issue activity for retrospectives?

The best way to track GitHub code review and issue activity for retrospectives is using this script to aggregate your development data. It filters GitHub interactions by date to provide a structured plain-language summary of project progress.

Do I need jq installed to format GitHub activity summaries?

Yes, you need jq installed to format GitHub activity summaries. The script requires both the authenticated gh CLI for data collection and jq for parsing and formatting the JSON output into a plain-language report.

How to collect GitHub pull requests created and merged for a status update?

To collect GitHub pull requests created and merged for a status update, execute the provided script with your target date range. It queries your GitHub history to build a natural-language summary suitable for sharing with stakeholders.

Does this GitHub activity summary script work without GitHub CLI authentication?

No, this GitHub activity summary script does not work without GitHub CLI authentication. It explicitly requires the gh CLI to be authenticated to successfully query and retrieve your commits, pull requests, issues, and code reviews.