In short:
ak-retroturns the git history of a time period into a retro report with real numbers and 3 to 5 recommendations. It does not hand off to a next skill; it stops at the report. Only when you pick HTML does it call onak-frontend-designandak-diagramto build the page. It only reads the repo: no commits, no code edits, no guessed numbers.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it at the end of a sprint, a week or a quarter, when you want to see what the team got done without counting by hand. The report covers Velocity, Code Health, commit type mix, the most edited files, plan progress, Highlights and Recommendations. Every derived metric comes with its formula so you can check it yourself.
flowchart LR
A["Git history for one period"] --> B["ak-retro"]
P["plans/ and gh if available"] --> B
B --> C["Retro report .md"]
B --> D["HTML page with --format html"]
C --> E["Stop, you read and decide"]
D --> EThe four core ideas of the skill:
| Idea | Question | Example |
|---|---|---|
| Time range | What period does the report cover? | Default 7 days; 2w, 1m, or 2026-07-01:2026-09-30 |
| N/A instead of guesses | What does the report say when data is missing? | No gh means N/A; a git error never becomes 0 commits |
| Metrics describe, they do not score | What do commit and line counts tell you? | Churn above 3x is a talking point, not anyone's productivity |
| One history snapshot | Which history are the numbers taken from? | Records HEAD revision, shallow clone or not, filters by committer date |
The most important caveat: the numbers are descriptive signals only. The test-to-code ratio counts file names, not test coverage, and the --team table is not a leaderboard.
Sample prompt for looking back at the past week:
/ak-retro 7dThe first argument is the time range: 7d (default), 2w, 1m, sprint or YYYY-MM-DD:YYYY-MM-DD. The flags:
| Flag | What it is for | Since ak |
|---|---|---|
--compare | Compares with the previous period | 1.0.0 |
--team | Splits metrics by author | 1.0.0 |
--format html|md | Picks the report format | 1.0.0 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Turns off illustrations in the HTML page | 2.13.0 |
Below is the detailed version: the run flow, 4 situations with prompts, each flag explained (when to use it, when you do not need it, what you get), the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-retro: turn git history into a retro report" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-retro". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-retro
