hs:retro

Generates data-driven retrospective reports from git history with velocity, code health, and hotspot metrics.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/Dozyboy/VSF --skill hs-retro-dozyboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hs:retro
Source: https://github.com/Dozyboy/VSF/tree/main/Day2_VSF/Demo1/harness/plugins/hs/disabled-skills/retro
Command: npx skills add https://github.com/Dozyboy/VSF --skill hs-retro-dozyboy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sprint retrospectives often rely on subjective impressions and guesswork. This Skill replaces opinion with objective data by mining git history to produce verifiable retrospective reports covering velocity, code health, commit patterns, and plan progress. ## Core Features & Use Cases - Git-Based Metrics Collection: Runs read-only git queries to compute commit frequency, active-day ratio, LOC churn, test-to-code ratio, and file hotspots, with documented formulas for every figure. - Comparison and Team Modes: Supports --compare to diff against the preceding period and --team for per-author breakdowns, with flexible timeframes like 7d, 2w, 1m, or explicit date ranges. - Actionable Outputs: Produces a structured Markdown report in plans/reports/, routes architectural lessons to a decision register and minor lessons to a backlog register. - Use Case: Before a sprint review, run the retro for the last two weeks with --compare to show whether test coverage and churn improved versus the prior period, then walk the team through data-backed action items. ## Quick Start Ask the assistant to generate a retrospective report for the last 7 days of git history with a comparison against the previous week.

Frequently Asked Questions about hs:retro

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

FAQPage Schema
How do I generate a sprint retrospective from git history?▼

Invoke the skill with a timeframe such as 7d, 2w, 1m, or an explicit date range. It runs read-only git log queries to compute velocity, churn, and test ratio, then writes a structured Markdown report to plans/reports/.

How to compare two sprint periods using git data?▼

Pass the --compare flag with your timeframe. The skill computes the same metrics for the immediately preceding period of equal length and adds delta columns showing absolute and percentage changes for each metric.

What metrics does a git-based retrospective report include?▼

The report covers commit frequency, active-day ratio, LOC added/removed/net, churn rate, test-to-code ratio, conventional commit type distribution, top-10 file hotspots, and plan task completion from checkbox counts.

Does the retrospective skill modify my code or git history?▼

No. The skill is strictly read-only: it only runs git log queries and scans plans/ and docs/. Its only write operation is saving the Markdown report into plans/reports/.

What happens if the gh CLI is not available during report generation?▼

Metrics that depend on the gh CLI are recorded as N/A in the report table rather than being skipped or fabricated. The skill never invents numbers; genuine zero counts are recorded as 0.

When should I use git retrospectives versus runtime telemetry analysis?▼

Use this skill for commit-level and code-health trends from version control history. Pair it with the hs:insights skill, which reads runtime telemetry, to get a complete picture of both development process and runtime behavior.