gh-activity
Reports your GitHub activity for a specific day using the gh CLI, showing commits, issues, and activity timeline. Use this when you need to review what you accomplished on GitHub for a particular date.
When & Why to Use This Skill
The GitHub Activity Reporter is a specialized Claude skill designed to automate the tracking and summarization of developer contributions. By leveraging the GitHub CLI (gh), it provides a comprehensive report of commits, issue interactions, and a chronological activity timeline for any specific date. This tool is ideal for developers looking to streamline their workflow, providing a clear audit trail of work performed without manual searching through repository histories.
Use Cases
- Daily Stand-up Preparation: Quickly generate a detailed list of your previous day's accomplishments, including specific commit messages and issue comments, to share during team sync-ups.
- Automated Work Logging: Effortlessly maintain a personal or professional log of GitHub activity for performance reviews, time-tracking, or project documentation.
- Sprint Progress Auditing: Review activity for specific historical dates to understand the context of changes made during a development cycle or to troubleshoot when specific features were implemented.
- Stakeholder Reporting: Compile clean, organized activity reports to provide project managers or clients with transparent updates on development velocity and task completion.
| name | gh-activity |
|---|---|
| description | Reports your GitHub activity for a specific day using the gh CLI, showing commits, issues, and activity timeline. Use this when you need to review what you accomplished on GitHub for a particular date. |
| license | MIT |
GitHub Activity Reporter
This skill reports your GitHub activity for a specific day using the gh CLI.
Usage
Run the script with an optional date argument (defaults to today):
# Get today's activity
bash gh-activity.sh
# Get activity for a specific date
bash gh-activity.sh 2025-12-15
The date format must be YYYY-MM-DD.
Requirements
gh(GitHub CLI) - must be authenticated with your GitHub accountjq- for JSON processing
What It Reports
Commits: Lists all commits you made with their actual commit messages, grouped by repository and branch.
Issues: Shows all issues you created, commented on, or interacted with, including issue titles and the type of interaction.
Activity Timeline: A chronological view of all your GitHub events for the day (pushes, PRs, issue comments, etc.).
How It Works
- Verifies you're authenticated with GitHub CLI
- Fetches your events using
gh api /users/{username}/events - Filters events to the specified date
- For each push event, fetches actual commits using
gh api /repos/{repo}/compare/{before}...{head} - Extracts and displays issue information from issue events
- Formats everything into a clear, organized report