Skip to main content
skill CX Codex

05-improve — Claude Code skill: what it does, how to install

05-improve examines conversation logs, evaluates visible token usage, and suggests targeted refinements without touching your code.

MIT ★ 571 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-framework
Open on GitHub

What 05-improve does

The skill processes a conversation ID or export file across three sequential stages in the actions/ directory. It inspects the chat record, generates advice, and identifies files for revision without asking for confirmation between steps.

All existing project files stay read-only. The skill writes its findings to a single temporary report and stops if the conversation data cannot be found.

It does not perform code delivery reviews or apply automatic edits. Its sole purpose is diagnosing conversational friction from recorded evidence.

What it helps with

  • pinpoint why an agent conversation burned excessive tokens
  • identify specific files that need revision after a prompt session
  • cut wasted interactive time during complex tasks

Example prompts for the agent

  • Review the conversation export.json and highlight wasted token spend
  • Inspect session-42 to suggest minimal improvements for the next run
  • Examine conversation session-id and recommend which files to edit

How to install 05-improve

1Plugin marketplace

/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-framework

This installs the whole aidd-refine plugin with all its skills

2Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill 05-improve -a claude-code

3Manually: put the files in place

~/.claude/skills/05-improve/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/05-improve/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 05-improve

How to install 05-improve in Claude Code?

Run npx skills add ai-driven-dev/framework --skill 05-improve -a claude-code in your terminal. You can also install it via marketplace commands: run /plugin marketplace add ai-driven-dev/framework followed by /plugin install aidd-refine@aidd-framework.

What does 05-improve do?

It evaluates a session log or export file, audits visible costs, and produces minimal recommendations to make future chats more efficient.

Does 05-improve modify project files directly?

No. The skill keeps repository files read-only and writes only an isolated temporary report.

Source text

SKILL.md · MIT
---
name: 05-improve
description: 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.
argument-hint: conversation | export
---
# 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.

© AI-Driven Dev · MIT · ai-driven-dev/framework

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set80

The whole set →
04-spec 04-spec writes spec.md, the contract for a single feature, from a request, a PRD or review notes. Or rewrites a spec that already exists. CX Codex +1 ★ 571repo stars resolve-conflict resolve-conflict resolves deterministic Git conflicts during merge, rebase, or cherry-pick. Stops right after staging modified files. CX Codex +1 ★ 571repo stars 0-deps-wiring The 0-deps-wiring rule sets where application dependencies are composed and how the graph is reused. It fits TypeScript projects with command handlers and use cases. CX Codex +1 ★ 571repo stars 01-plan 01-plan turns a request, a ticket or a file into a phased implementation plan: gather the input, read the code, hand back a plan. CX Codex +1 ★ 571repo stars 1-documentation The 1-documentation rule guides edits to project Markdown: it keeps decisions and useful commands while removing repetition and temporary records. It applies to selected files and folders. CX Codex +1 ★ 571repo stars 03-prd 03-prd turns a need, idea or brainstorm into a structured product requirements document: a draft from a template, saved only once you approve it. CX Codex +1 ★ 571repo stars 08-three-amigos 08-three-amigos evaluates epics and user stories through product, delivery, or quality perspectives, then reconciles three separate reports before backlog edits. CX Codex +1 ★ 571repo stars 10-learn 10-learn — a skill for Claude Code, Cursor, and other platforms that records decisions, conventions, lessons, and code review findings as durable project knowledge. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open