# ax-extract-workflow

Traces which skills, in what order, produced a finished artifact — a demo, a PR, a feature. Handy when you want to repeat a run that worked.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 121
- 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/ax-extract-workflow/SKILL.md
- Updated: 2026-10-07
- HTML: https://affpapa.org/en/nevibecode/skills/ax-extract-workflow

## What it does

Give the skill an anchor: a date, a commit sha, or a topic name. It resolves that anchor through `ax`, then pulls the sessions that matter and reads their `top_skills` and `agent_delegations` arrays. What comes back is an ordered arc — the framing skill that opened the work first, execution skills next, verification last — with one line per skill about what it produced.

The flow has four steps: resolve the anchor, window the sessions, inspect each one, narrate. In topic mode it first hunts for candidate shas with `ax recall "<topic>" --sources=commit --json`; when the hits are ambiguous it asks you to pick one before going further. Alongside the arc it lifts two to four turns where you steered the work, each with a quote and a session id.

Everything stays in chat. The skill writes no files, leaves `.ax/tasks/` alone, and never touches the repo. It expects `ax` (axctl) on `PATH`; if `ax sessions here` fails, it stops and points you at the DuckDB dylib setup in `docs/development.md#setup`. Generic asks like “show recent activity” are out of scope — that belongs to `ax sessions here`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Necmttn/ax ax-extract-workflow
```

2. **Manually: put the files in place**
- File: `.github/skills/ax-extract-workflow/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ax-extract-workflow -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/ax-extract-workflow/SKILL.md

## When to use it
- rebuild the skill order behind a shipped feature
- locate sessions by date or sha and tie them to an artifact
- surface the turns where you changed direction
- see which subagents took part in a piece of work
- draft a short brief for repeating the same run

## Example prompts
- What made this feature work? Reconstruct the workflow.
- Extract workflow from commit `a1b2c3d`.
- Show me how I shipped the report export last week.

## Similar
- [modernize-extract-rules](https://affpapa.org/en/nevibecode/commands/modernize-extract-rules.md) — command · ★ 44770
- [extract](https://affpapa.org/en/nevibecode/skills/extract.md) — skill · 1613 installs
- [sentry-react-sdk](https://affpapa.org/en/nevibecode/skills/getsentry-sentry-react-sdk.md) — skill · 579 installs
- [investigating-replay](https://affpapa.org/en/nevibecode/skills/investigating-replay.md) — skill · 389 installs
- [finding-replay-for-issue](https://affpapa.org/en/nevibecode/skills/finding-replay-for-issue.md) — skill · 375 installs
- [tavily-extract](https://affpapa.org/en/nevibecode/skills/tavily-extract.md) — skill · 18100 installs

From the same set: [necmttn/ax](https://affpapa.org/en/nevibecode/by/necmttn/ax.md) — 3 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