Voyteck/claude-skill-retro

English · Polski
A Claude Code plugin that brings an Agile-style continuous improvement process into working with Claude. Every few
working days (recommended: every 2) the retro:
1. reviews commitments from previous retros: were they kept and did they have an effect;
2. gathers evidence from Claude Code transcripts, git and GitHub (user messages, answers to questions,
blocks, refused and failed tool calls by cause, subagents, PRs, CI, size of rules files, tokens and cost at API
prices: context, share of subagents and Opus, wake-ups of long sessions, cloud sessions, cost per 10% of the
plan) and measures writing efficiency: cost by agent role and
model, fix rounds in merged PRs by author model, returns from review and CI, cost and quality per PR by
implementer model, reasoning effort and PR size, compared with the previous 3 retros, to tune which agent, model
and effort does which task;
3. assesses what worked and what did not, also on the user's side (optional);
4. proposes at most 5 changes, preferring mechanisms (tests, hooks, templates) over text-only rules;
5. implements the accepted changes in rules files (CLAUDE.md, memory, nauki.md) and the commitments
register.
If there has been no retro for 5 working days, a new Claude Code session reminds you (SessionStart hook).
Since 0.5.0 retro also replaces the claude-usage-report
skill: its measurements (tokens and context, cache rebuilds, refused tool calls by cause, cloud session cost, cost
per merged PR and per 10% of the plan, comparison with the previous measurement) are part of every retro.
## Languages
The retro talks and writes in the language chosen on first run (jezyk in konfiguracja.json):
pl and en have their own templates and script reports;
any other language: Claude writes in it, templates and script reports are in English.
Recognition does not depend on the language: an option marked as recommended is recognized in many languages
("(Recommended)", „(rekomendowane)”, "(recomendado)", "(empfohlen)", …), a completed retro is zakończone,
completed, done or closed, a question about a fact starts with [fact] or [fakt].
Identifiers stay Polish in every language: file names in the working directory (zobowiazania.md, nauki.md,
konfiguracja.json), configuration keys, CSV columns, script names and arguments. Code comments are in Polish
too. The glossary is in plugins/retro/skills/retro/references/konfiguracja.md.
## Requirements
Claude Code (CLI or the Code tab of the desktop app), local sessions;
Python ≥ 3.8 in PATH (python3, python or py), standard library only;
git; optionally gh logged in to an account with access to the repositories (PR and CI metrics);
bash for the reminder hook (on Windows: Git Bash, which Claude Code requires anyway).
## Installation from the GitHub repo (recommended)
1. In Claude Code, on every account and computer where it should work:
/plugin marketplace add Voyteck/claude-skill-retro
/plugin install retro@retro
The same from a terminal: claude plugin marketplace add Voyteck/claude-skill-retro and
claude plugin install retro@retro.
2. A new session (or /reload-plugins).
Your own copy (a fork or a new repo from this package) installs the same way, with / instead of