weekly-review

Generates weekly summaries of authored commits with classifications of bug fixes, tech debt, and net-new work.

Updated May 18, 2025
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill weekly-review-nthpaul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-review
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/plugins/cache/cursor-public/cursor-team-kit/d1cdb88a9eb33cf392395c87e3fd76419fc1010e/skills/weekly-review
Command: npx skills add https://github.com/nthpaul/dotfiles --skill weekly-review-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly summarize what you shipped over the past week without manually reading through every commit and guessing the themes.

Core Features & Use Cases

  • Weekly commit synthesis: Collects authored, non-merge commits from the last 7–10 days to form a concise weekly narrative.
  • Highlights by work type: Produces 2–5 bullet points grouped into meaningful change categories.
  • Work classification: Adds a short classification paragraph estimating likely bug fixes, likely tech debt, and likely net-new functionality for planning or status updates.

Quick Start

Ask the AI to run a weekly review of your recent authored commits for the primary branch and produce a short bullet recap plus a bugfix/tech-debt/net-new classification.

Frequently Asked Questions about weekly-review

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

FAQPage Schema
How do I summarize my git commit history into an executive weekly recap?

To summarize git commit history into a weekly recap, the tool extracts authored non-merge commits from the last 7-10 days, categorizes them into bug fixes, tech debt, and net-new work, and generates 2-5 grouped bullet points for status updates.

What is the best way to classify recent commits into bugfix, tech debt, and net-new work?

Classifying recent commits into bugfix, tech debt, and net-new work involves analyzing authored commit diffs on the primary branch to estimate work categories, producing a concise paragraph for engineering planning and retrospectives.

Can I generate a weekly release notes summary from my primary branch commits?

Yes, you can generate a weekly release notes summary by extracting authored commits from the primary branch over the past 7-10 days, filtering out merge commits, and grounding the recap strictly in the actual commit history and meaningful diffs.

Does the weekly review process exclude merge commits when generating a status update?

Yes, the weekly review process explicitly excludes merge commits when generating a status update, ensuring the synthesis focuses strictly on authored, non-merge commits and meaningful diffs from the primary branch.

How many bullet points will the commit history recap produce for my retrospective?

The commit history recap produces 2-5 bullet points for your retrospective, grouping meaningful diffs from the past 7-10 days of activity into concise change categories.

Do I need a configured git user identity to extract commits for the weekly synthesis?

Yes, you need a configured git user identity because the weekly synthesis extracts commits specifically authored by that user identity from the primary branch to build the recap.