Agent skill · writing content · rtk-ai
repo-recap
Generate a comprehensive repo recap (PRs, issues, releases) for sharing with team. Pass "en" or "fr" as argument for language (default fr).
Why this skill is useful
Adds a Bash script that automates the generation of a comprehensive repository recap, including PRs, issues, and releases, which the AI wouldn't reliably generate on its own.
What it needs
Requires gh installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 75,070 stars on the source repository.
What this skill does
Repo Recap Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive summary. Output is formatted as Markdown with clickable GitHub links, ready to share. Language Check the argument passed to this skill If en or english → produce the recap in English If fr, french, or no argument → produce the recap in French (default) Preconditions Before gathering data, verify: If either fails, stop and tell the user what's missing. Steps 1. Gather Data Run these commands in parallel via gh CLI: Note: author in JSON results is an object {login: "..."} — always extract .author.login when processing. 2. Determine Maintainers To distinguish "our PRs" from external contributions: If this fails (permissions), fallback: authors with write/admin access are those who merged PRs recently. When in doubt, ask the user. 3. Analyze and Categorize PRs — Categorize into 3 groups: Our PRs (author is a repo collaborator): List with PR number (linked), title, size (+additions, files count), status External — Reviewable (manageable size, no major blockers): Additions ≤ 1000 AND files ≤ 10 No merge conflicts, CI not failing Include: PR link, author, title, size, review status, recommended action External — Problematic (any of: too large, CI failing, overlapping, merge conflict): Additions > 1000 OR files > 10 OR CI failing (reviewDecision = "CHANGESREQUESTED" or checks failing) OR touches same files as another open PR (= overlap) Include: PR link, author, title, size, specific problem, action taken/needed Size labels (use in "Taille" column for quick visual triage): Label Additions ----- --------- XS < 50 S 50-200 M 200-500 L 500-1000 XL > 1000 Format: +{additions}, {files} files ({label}) — e.g., +245, 2 files (S) Detect overlaps: Two PRs overlap if they modify the same files. Use changedFiles from the JSON data. If >50% file overlap between 2 PRs, flag both as overlapping and cross-reference them. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills rtk-ai/repo-recap