Skip to main content
skill CX Codex

skill-improver · bfollington — Claude Code skill: what it does, how to install

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.

CC-BY-SA-4.0 102 installs ★ 53 updated 2026-08-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bfollington/terma --skill skill-improver -a claude-code
Open on GitHub

What skill-improver 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.

What it helps with

  • 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 for the agent

  • 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.

How to install skill-improver

1Skills CLI (Vercel)

npx skills add bfollington/terma --skill skill-improver -a claude-code

2Manually: put the files in place

~/.claude/skills/skill-improver/SKILL.md

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

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

Questions about skill-improver

How do I install skill-improver in Claude Code?

Run npx skills add bfollington/terma --skill skill-improver -a claude-code. The skill file is located at ~/.claude/skills/skill-improver/SKILL.md.

What does skill-improver do?

It examines a specific problem and helps determine whether a skill caused it. The suggested response may be a trigger adjustment, revised guidance, a carefully chosen addition, or no change.

When does skill-improver recommend changing a skill?

A recurring issue can warrant a change. For a one-time failure, it makes an exception when the consequences were costly or irreversible.

Similar skills

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

skill-improver by other authors comes first.

skill-improver trailofbits The skill-improver skill runs repeated reviews and fixes on another skill until the review has no critical or major findings. It relies on the plugin-dev reviewer agent. CX Codex +1 5,600installs skill-improver Galaxy-Dawn skill-improver applies recommendations from skill review plans to Claude Code skill files. Backs up original files and checks YAML syntax. CX Codex +1 406installs pr-improver trailofbits The pr-improver skill cycles through review and fixes for the current branch’s changes. Use it to address findings before opening or updating a pull request. CX Codex +1 1,600installs code-improver trailofbits code-improver runs a review-and-fix loop over any code target — module, plugin, directory — with a reviewer you name yourself. CX Codex +1 1,600installs prompt-improver dotneet The prompt-improver skill reviews prompts, spots missing context and turns vague requests into clearer instructions. Use it when an agent task lacks scope or checks. CX Codex +1 519installs agents-md-improver waybarrios agents-md-improver audits project rule files and suggests focused updates so coding agents retain current repository context. Use it when AGENTS.md or CLAUDE.md needs review. CX Codex +1 145installs skill-management oakoss skill-management — a Claude Code skill for creating, reviewing, and validating skills against the Agent Skills standard. It comes into play during structure checks, description edits, and manifest comparisons. CX Codex +1 105installs claude-md-improver official Anthropic The claude-md-improver skill audits CLAUDE.md files, produces a quality report, and suggests focused edits. Use it when project instructions need a careful review. CX Codex +1 12,558installs

From the same set5

Project sponsors

Companies that keep this analytics open