# retro-meta

Runs a deeper investigation across past retros and the current ax setup to surface fixes the regular heuristic missed. Triggered by phrases like "deep retro" or the /ax:retro-meta command.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 124 repo stars
- Author: Necmttn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Necmttn/ax/tree/HEAD/skills/retro-meta/SKILL.md
- Updated: 2026-10-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/retro-meta

## What it does

The skill hands reasoning to an external agent, Claude Code or Codex with a high thinking budget, while the `ax` CLI just gathers structured evidence and takes back any plan the user approves. It first checks already-accepted experiments that still lack a locked verdict, closing them with `ax improve verdict` or leaving them open when there isn't enough signal yet. It then works through the investigation prompts, reading skill files and the `CLAUDE.md` guidance files, and proposes findings for the user to confirm.

It needs `axctl` on `PATH`; if `ax doctor` fails, the skill stops and points to the DuckDB setup section in the docs. A useful run also needs at least three retros logged in the past month — fewer than that, and the skill suggests running `ax:retro` first to build up evidence.

It never writes a new skill file directly. Instead it drafts a plan under `~/.claude/plans/`, asks for an explicit yes, and only then registers it through `ax retro plan`. Approved plans can optionally be handed to an internal scaffolding agent via `ax improve accept --with-agent`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill retro-meta -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/retro-meta/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/retro-meta/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill retro-meta -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/retro-meta/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill retro-meta -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/retro-meta/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Necmttn/ax skills/retro-meta
```

2. **Manually: put the files in place**
- File: `.github/skills/retro-meta/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill retro-meta -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Necmttn/ax --path skills/retro-meta
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/retro-meta/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill retro-meta -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Necmttn/ax/tree/HEAD/skills/retro-meta/SKILL.md

## When to use it
- spot ax setup improvements the standard heuristic doesn't surface
- resolve stalled experiment proposals and lock their verdicts
- check skill files and CLAUDE.md for duplicates before proposing changes
- draft a change plan backed by evidence from prior retros
- hand an approved plan off for automatic skill or hook scaffolding

## Example prompts
- Run a deep retro on my ax setup
- /ax:retro-meta
- Investigate what's wrong with my agent setup

## Similar
- [printing-press-retro](https://affpapa.org/en/nevibecode/skills/printing-press-retro.md) — skill · 6800 installs
- [retro-marimo-pair](https://affpapa.org/en/nevibecode/skills/retro-marimo-pair.md) — skill · 5600 installs
- [om-pipeline-retro](https://affpapa.org/en/nevibecode/skills/om-pipeline-retro.md) — skill · 3100 installs
- [launch-retro-analyzer](https://affpapa.org/en/nevibecode/skills/launch-retro-analyzer.md) — skill · 1100 installs
- [w-retro](https://affpapa.org/en/nevibecode/skills/w-retro.md) — skill · 647 installs
- [lab-retro](https://affpapa.org/en/nevibecode/skills/lab-retro.md) — skill · 182 installs

From the same set: [necmttn/ax](https://affpapa.org/en/nevibecode/by/necmttn/ax.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
