weekly-leaderboard

Generates and posts a weekly engineering shipping brief with PR leaderboard to Slack.

20.2k|3.4k|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/kortix-ai/suna --skill weekly-leaderboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-leaderboard
Source: https://github.com/kortix-ai/suna/tree/main/packages/starter/templates/marketplace/runtime/skills/weekly-leaderboard
Command: npx skills add https://github.com/kortix-ai/suna --skill weekly-leaderboard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Engineering teams lack a consistent, data-grounded weekly summary of what shipped and who shipped it, forcing managers to manually compile GitHub activity and Slack context into a digest.

Core Features & Use Cases

  • Merged PR Leaderboard: Counts merged PRs per author across target repositories using the GitHub CLI, with week-on-week deltas, bar charts, and bot/agent exclusions.
  • Shipping Streaks and Deltas: Reads a persistent memory ledger to compute multi-week shipping streaks and per-person count changes.
  • Slack Publishing with Standup Thread: Posts a Block Kit brief to a Slack channel and replies with an async standup prompt, then records the run in a memory ledger.
  • Use Case: A cron-triggered agent runs every Monday, pulls the last 7 days of merged PRs from the team's repos, and posts a ranked leaderboard plus standup thread to the engineering Slack channel.

Quick Start

Ask the agent to run the weekly leaderboard for the last 7 days across your target repositories and post the shipping brief to your Slack channel.

Frequently Asked Questions about weekly-leaderboard

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

FAQPage Schema
How do I generate a weekly GitHub PR leaderboard for my team?

Use the GitHub CLI to list merged PRs per author across your target repositories with gh pr list --state merged --search "merged:>=<date>". The skill groups results by author, excludes bot accounts, and renders a ranked leaderboard with deltas and streaks.

How to post a formatted leaderboard message to Slack?

Post using Slack Block Kit via slack send --channel <id> --blocks-file <path> --text <fallback>. Always include a plain-text fallback and pass the channel explicitly, then use slack reply with the returned message ts to create the standup thread.

Are bot and Dependabot PRs counted in the leaderboard?

No. PRs authored by dependabot, github-actions, agent-* accounts, and logins ending in [bot] are excluded from individual counts and reported on a separate summary line. Human-driven PRs count even if an agent assisted.

How are shipping streaks tracked between weekly runs?

Streaks are stored in a memory ledger file at .kortix/memory/weekly-digests.md. Each run increments streaks for contributors with at least one merged PR and resets the rest, keeping the last 8 weeks of entries.

What happens if no PRs were merged during the week?

The leaderboard section is skipped and noted in the snapshot, but the run still posts an honest one-line summary plus the async standup thread prompt so the team check-in continues.