Send Weekly GitHub Team Report
Analyzes seven days of GitHub activity to generate a weekly engineering velocity report and delivers contributor leaderboards straight to your inbox.
What It Does
This workflow runs every Monday morning to analyze the past seven days of GitHub activity across all your repositories. It generates a contributor leaderboard highlighting commits, merged pull requests, and closed issues per person. Along with a repository breakdown and actionable engineering manager insights, it delivers a structured HTML report straight to your inbox before your Monday team meeting begins.
Why It Matters
Engineering managers often spend valuable time every Monday piecing together what the team shipped before running a standup. This workflow handles that analysis in the background, giving you immediate visibility into team output at zero manual effort so you can start your day fully prepared.
How It Works
- Scheduled Trigger: Fires automatically every Monday at 8 AM UTC.
- GitHub Integration: Fetches all commits, merged pull requests, and closed issues from the past seven days across your accessible repositories.
- AI Agent: Processes the data to build a contributor leaderboard, a per-repository breakdown, a list of notable merges, and three management insights based on the week's patterns.
- Email Delivery: Sends the formatted weekly report directly to your Gmail inbox.
What You Get
- Week-at-a-glance summary showing total commits, pull requests, issues, and active contributors.
- Contributor leaderboard ranked by overall activity.
- Repository breakdown table showing activity per project.
- Top notable pull request merges.
- Three engineering manager insights regarding velocity trends, contributor balance, and recommendations for the next sprint.
Who It Is For
- Engineering managers running weekly team reviews.
- Tech leads needing visibility into team output without manually checking GitHub.
- CTOs looking for a lightweight engineering pulse report.
- Team leads managing distributed or remote engineering teams.
Configuration Guide
| Step | Action | Description |
|---|---|---|
| 1 | Connect GitHub | Provide repository read access to fetch activity data. |
| 2 | Connect Gmail | Link your email account to receive the final report. |
| 3 | Adjust Schedule (Optional) | Change the cron expression to run on Fridays instead of Mondays (for example, 0 8 * * 5). |
| 4 | Adjust Timezone (Optional) | The default is 8 AM UTC. Update the scheduled trigger settings to match your local timezone delivery preference. |
| 5 | Expand Window (Optional) | Update the AI agent prompt to review 14 days of data if your team works in biweekly sprint cycles. |
Built By
Shamanth Kumar M, a Staff Technical Program Manager with extensive experience in engineering delivery. He builds intelligent systems that replace manual tasks, ranging from sprint tracking to delivery health dashboards.
Want to showcase your own workflows?
Become a Needle workflow partner and turn your expertise into recurring revenue.
