ax-narratelisted
Install: claude install-skill Necmttn/ax
# ax:narrate - write the session's story as a structured narration
You were there. This skill turns YOUR OWN memory of the session into a
reviewable artifact: 3-7 stops in reading-flow order, each anchored to
real evidence - code hunks, turn numbers, user quotes, failures. The
point is to capture what a PR diff never shows: the corrections, the
dead ends, the recoveries.
The artifact validates against `SessionNarration` in
`apps/studio/src/routes/narration-types.ts` and renders in ax studio.
## Step 1 - identify the session
- Preferred: `ax sessions here --days=1 --json` and pick the current
session's id (the one matching this conversation). Use the short id.
- If `ax` is unavailable or the session isn't ingested yet, derive a
slug: `<repo>-<YYYYMMDD-HHmm>`. Note in `meta` that turn seqs are
best-effort ordinals in that case.
- If available, `ax sessions show <id> --json` gives you the real turn
seqs to anchor against. Prefer real seqs over guesses.
## Step 2 - reconstruct the story from your own context
Re-read the conversation in your head before writing anything:
1. What did the user originally ask for? (intent)
2. What existed before, what exists now? (before/after)
3. Where did the user redirect or correct you? EVERY one of these
becomes a `correction` anchor. No exceptions.
4. Which tool failures actually mattered (changed your approach, cost
real time, forced a workaround)? Each becomes a `tool_failure`
anchor. Skip trivial retries that changed