ck:retro

Generate markdown or HTML sprint retrospective reports from git metrics.

1|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/Thanh-apero/apero-kit-cli --skill ck-retro-thanh-apero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck:retro
Source: https://github.com/Thanh-apero/apero-kit-cli/tree/main/.claude/skills/retro
Command: npx skills add https://github.com/Thanh-apero/apero-kit-cli --skill ck-retro-thanh-apero

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the collection and analysis of git metrics to generate a structured report for sprint retrospectives, reducing the time spent on manual analysis and enabling data-driven insights.

Core Features & Use Cases

  • Git Metrics Analysis: Automatically computes various metrics from git history such as commit frequency, code churn, and file hotspots.
  • Retrospective Report Generation: Creates a detailed markdown or HTML report that includes performance metrics, commit distribution, and code health indicators.
  • Interactive Timeframe Selection: Allows selection of analysis period through flags like --timeframe, with options like 7d, 2w, 1m, sprint, or custom date ranges.
  • Output Format Flexibility: Provides the option to generate output in markdown (md) or HTML (html) format.

Quick Start

Run the following command to generate a markdown report for the last 7 days:

ck retro --timeframe 7d

Frequently Asked Questions about ck:retro

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

FAQPage Schema
How do I automate sprint retrospective report generation using git history?

You can automate sprint retrospective report generation by computing git metrics like commit frequency, code churn, and file hotspots to produce a structured markdown or HTML report. This reduces manual analysis time and provides data-driven insights.

What git metrics are analyzed for a data-driven retrospective?

Data-driven retrospectives analyze git metrics such as commit frequency, code churn, file hotspots, and commit distribution. These code health indicators are automatically extracted from your git history to highlight performance trends.

Does retrospective report generation work with GitHub issues tracking?

Yes, retrospective report generation works with GitHub issues tracking by optionally utilizing the gh command-line tool. While git is required for core commit and code churn analysis, gh integration allows you to pull additional issue data into the report.

Can I generate a markdown or HTML retrospective report for a custom date range?

Yes, you can generate a markdown or HTML retrospective report for a custom date range. The tool supports configurable timeframes, allowing you to use preset options like 7d, 2w, 1m, sprint, or specify custom date ranges via flags.

What's the best way to analyze code churn and file hotspots for a sprint?

The best way to analyze code churn and file hotspots for a sprint is to run an automated git metrics analysis over your selected timeframe. This automatically computes the data and structures it into a detailed report highlighting code health indicators.

Do I need git installed to generate code health and retrospective reports?

Yes, you need git installed to generate code health and retrospective reports because it is the required dependency for extracting commit history and code churn data. The gh tool is optional and only needed for GitHub issues tracking.