# improve-system

Inspects past session logs and correction history to uncover recurring agent mistakes. Suggests targeted prompt edits and audits token consumption.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 551 installs · ★ 3
- Author: gasserane
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gasserane/personal-skills/tree/HEAD/skills/improve-system/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/improve-system

## What it does

This skill reviews session histories, QA logs, and cost calibration tables to spot habitual missteps. It parses files such as `qa-rejection-log.md`, `cost-calibration-log.md`, and feedback notes inside `.remember`. Instead of acting on isolated slips, it requires two independent occurrences before bundling an issue into an action item.

Once patterns are clustered, the assistant compiles concrete changes for review. These include edits to `CLAUDE.md`, updates to individual skills, or custom `PreToolUse` hooks. Every proposal requires manual confirmation. The skill never updates files autonomously, presenting a numbered overview for approval instead.

The routine relies on structured tracking logs inside the `agent-improvements` directory. Without recorded session notes and feedback logs in the workspace, the analysis will find no data to evaluate.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill improve-system -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill improve-system -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill improve-system -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gasserane/personal-skills improve-system
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill improve-system -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gasserane/personal-skills --path skills/improve-system
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill improve-system -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/gasserane/personal-skills/tree/HEAD/skills/improve-system/SKILL.md

## When to use it
- identify recurring agent failure patterns across recent chats
- monitor the QA rejection rate metric over time
- pinpoint why specific sessions consumed too many tokens
- turn repeated human corrections into standing rules for `CLAUDE.md`

## Example prompts
- /improve-system
- Check recent sessions and show what the agent keeps getting wrong
- Why was that session expensive? Run a token audit

## 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: [gasserane/personal-skills](https://affpapa.org/en/nevibecode/by/gasserane/personal-skills.md) — 29 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