# 05 Improve

> Reads complete conversation evidence, measures visible cost, and recommends minimal improvements. Use when the user wants to improve a conversation, reduce wasted time or tokens, or choose files to revise. Not for delivery review or automatic edits.

- Skill: `ai-driven-dev/05-improve` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add ai-driven-dev/05-improve`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/05-improve/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/ai-driven-dev/05-improve

---

# Improve

```mermaid
flowchart LR
  start([conversation ID or export]) --> read-conversation
  read-conversation -->|complete| recommend --> target-edits
  read-conversation -->|unavailable| unavailable([stop])
  target-edits --> question([ask next intent]) --> stop([stop])
```

## Actions

Run all three actions in order without confirmation. Read only the next file in `actions/`.

| Order | Action |
| --- | --- |
| 1 | `01-read-conversation.md` |
| 2 | `02-recommend.md` |
| 3 | `03-target-edits.md` |

## Transversal rules

- Access only the selected conversation and its relevant sources.
- Use recorded evidence only; mark unavailable measurements as such.
- Keep project files read-only; write only a unique temporary report.

