retro · necmttn — Claude Code skill: ax experiment-loop retrospective
Runs a guided session over the ax agent-experience graph. Shows open proposals, pending verdicts, and hook effectiveness signals.
npx skills add Necmttn/ax --skill retro -a claude-codeWhat retro does
Fires on /ax:retro or phrases like "ax retrospective", "review my ax proposals", "triage proposals". Reads data via ax improve and ax hooks, lists proposals by frequency and confidence. Each proposal is a hypothesis about where the agent can improve: add a pre-tool guard, reduce recurring user corrections, or eliminate a friction pattern.
Starts with ax improve checkpoint to snapshot measurements. Then shows open proposals (skill or guidance form), experiments awaiting verdict, and a hook summary for the last seven days. The user decides per row: accept with scaffolding, reject, or confirm the suggested verdict.
Requires axctl on PATH and configured DuckDB dylib. Without them, ax improve list fails and the skill stops with a pointer to docs/development.md#setup. Does not fire on generic phrases like "look at my recent work" — only on explicit retro triggers.
What it helps with
- triage the queue of agent improvement proposals
- lock verdicts for finished experiments
- review hook effectiveness over the past week
- drain backlog retros from previous sessions
Example prompts for the agent
- Run an
ax retroand show me the open proposals - Start an ax retrospective, I want to lock the pending verdicts
- Check experiment loop status and list what needs a decision
How to install retro
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill retro -a claude-code2Manually: put the files in place
~/.claude/skills/retro/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/retro/
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill retro -a codex2Manually: put the files in place
.agents/skills/retro/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill retro -a cursor2Manually: put the files in place
.cursor/skills/retro/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax retro2Manually: put the files in place
.github/skills/retro/SKILL.md1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill retro -a gemini-cli2Platform CLI
gemini skills install https://github.com/Necmttn/ax --path skills/retroManually: put the files in place
.devin/skills/retro/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Necmttn/ax --skill retro -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about retro
How to install retro in Claude Code?
Run npx skills add Necmttn/ax --skill retro -a claude-code, the skill will appear in ~/.claude/skills/retro/SKILL.md.
What does retro do?
Runs a guided session over the ax experiment graph: shows open proposals, unlocked verdicts, and hook effectiveness summary. The user decides per row what to do next.
What does retro require to work?
Installed axctl on PATH and configured DuckDB dylib. If ax improve list fails, the skill points to docs/development.md#setup and stops.
Similar skills
All skills for Agent setup: memory, context, orchestration →retro by other authors comes first.