# tune

tune reviews one coding session and records proposed agent-environment changes in ax. Use it to trace tool errors, wasted calls, and missing checks.

- 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/tune/SKILL.md
- Updated: 2026-10-07
- HTML: https://affpapa.org/en/nevibecode/skills/tune

## What it does

The skill reads a session log and builds a ledger of tool calls, errors, denials, and retries. It then looks for possible changes to checks, guidance files, hooks, or information access. The ledger comes from `python3 -I scripts/turns.py <log>`; add `--full` to inspect individual commands.

Candidates are ranked by severity and filed in ax for later triage with `/ax:retro`. tune also prepares a brief for the session. It applies changes only when asked.

The session log must be accessible, and the ledger script needs Python 3. The skill scopes ingestion to the current session: bare `ax ingest` scans every transcript on the machine, so that command can use more resources.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Necmttn/ax tune
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- trace the cause of failed or repeated tool calls
- spot mistakes that an automated check could catch
- separate mechanical coding rules from review guidance
- file environment-change candidates in ax

## Example prompts
- Run a retrospective on this session with `/ax:tune`.
- Review this session and file setup-change proposals in ax.
- Find tool-use problems in this session and suggest checks.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

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