# skill-improver

The skill-improver Claude Code skill reviews problems with other skills and weighs possible changes. It runs at the end of a substantial session or after an issue recurs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 102 installs · ★ 53 repo stars
- Author: bfollington
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bfollington/terma/tree/HEAD/plugins/terma/skills/skill-improver/SKILL.md
- Updated: 2026-08-30
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bfollington-skill-improver

## What it does

skill-improver helps trace a concrete snag to the skill that may have contributed to it. It distinguishes a broken trigger from instructions that were loaded but missed the situation, then suggests whether to revise the trigger or the skill’s content.

It treats recurring issues differently from one-off events and favors rewriting or trimming existing guidance over adding another clause. A repeated problem can justify a change; a single incident does so only when it was costly or irreversible.

Install it for Claude Code with `npx skills add bfollington/terma --skill skill-improver -a claude-code`. The skill file is at `~/.claude/skills/skill-improver/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bfollington/terma --skill skill-improver -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bfollington/terma --skill skill-improver -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bfollington/terma --skill skill-improver -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bfollington/terma plugins/terma/skills/skill-improver
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bfollington/terma --skill skill-improver -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bfollington/terma --path plugins/terma/skills/skill-improver
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bfollington/terma --skill skill-improver -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/bfollington/terma/tree/HEAD/plugins/terma/skills/skill-improver/SKILL.md

## When to use it
- find why a skill failed to activate
- decide whether a trigger or instruction needs revision
- separate recurring friction from a one-off issue
- reduce unnecessary guidance instead of appending more
- judge whether a single failure warrants a skill change

## Example prompts
- Work out why the skill did not activate in this session and whether its trigger needs changing.
- The same issue has come up again. Suggest a focused change to the relevant skill.
- Review this failure and see whether clearer, shorter guidance would address it.

## Similar
- [pr-improver](https://affpapa.org/en/nevibecode/skills/pr-improver.md) — skill · 1600 installs
- [code-improver](https://affpapa.org/en/nevibecode/skills/code-improver.md) — skill · 1600 installs
- [prompt-improver](https://affpapa.org/en/nevibecode/skills/prompt-improver.md) — skill · 519 installs
- [agents-md-improver](https://affpapa.org/en/nevibecode/skills/agents-md-improver.md) — skill · 145 installs
- [skill-management](https://affpapa.org/en/nevibecode/skills/skill-management.md) — skill · 105 installs
- [claude-md-improver](https://affpapa.org/en/nevibecode/skills/claude-md-improver.md) — skill · 12558 installs

## Other versions with the same name
- [skill-improver · trailofbits](https://affpapa.org/en/nevibecode/skills/skill-improver.md) — 5600 installs
- [skill-improver · galaxy-dawn](https://affpapa.org/en/nevibecode/skills/galaxy-dawn-skill-improver.md) — 406 installs

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