ck:retro

Generate engineering retrospective reports from git history with Markdown or HTML output.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/jangtrinh/demo-Lam --skill ck-retro-jangtrinh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck:retro
Source: https://github.com/jangtrinh/demo-Lam/tree/main/.claude/skills/retro
Command: npx skills add https://github.com/jangtrinh/demo-Lam --skill ck-retro-jangtrinh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates opinion-based retrospectives by collecting objective git metrics for a given period and turning them into a structured, evidence-backed report.

Core Features & Use Cases

  • Git metrics for velocity and code health: Computes commit cadence, active days, LOC added/removed/net, and churn rate from git history.
  • Quality signals and risk hotspots: Identifies commit type distribution and top file hotspots, and calculates a test-to-code ratio.
  • Plan- and issue-aware completion tracking: Scans a plans directory for checkbox progress and optionally includes closed GitHub issue context when the GitHub CLI is available.

Quick Start

Run ck:retro for the last 7 days, optionally break down results by author, and output the report in Markdown.

Frequently Asked Questions about ck:retro

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

FAQPage Schema
How do I generate an engineering retrospective report from git history?

To generate an engineering retrospective report from git history, this Skill collects commit cadence, active days, and LOC metrics for a specified timeframe, producing structured Markdown or self-contained HTML output. It applies deterministic date-range resolution to compute derived indicators for sprint or weekly cycles.

What git metrics can I use for a data-driven sprint retrospective?

Git metrics for a data-driven sprint retrospective include commit cadence, active days, LOC added, removed, and net changes. The Skill also computes churn rate, commit type distribution, top file hotspots, and a test-to-code ratio proxy to identify code health and risk areas.

Can I break down git churn analysis by author for a specific period?

Yes, you can break down git churn analysis by author for a specific period. The Skill supports per-author breakdowns and period comparison, allowing you to evaluate individual contributions and velocity trends across sprint, weekly, or ad-hoc review cycles.

Does the retrospective report require external issue tracking tools to work?

The retrospective report does not require external issue tracking tools, relying strictly on git-based metric collection with no invented values. It optionally scans a plans directory for checkbox progress and includes closed GitHub issue context if the GitHub CLI is available.

What is the best way to track code health and risk hotspots from git activity?

The best way to track code health and risk hotspots from git activity is by computing churn rate, commit type distribution, and top file hotspots. This Skill calculates these derived indicators alongside a test-to-code ratio proxy to highlight problematic areas objectively.