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
npx skills add bfollington/terma --skill skill-improver -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/skill-improver/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-improver/
1Skills CLI (Vercel)
npx skills add bfollington/terma --skill skill-improver -a codex2Manually: put the files in place
.agents/skills/skill-improver/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bfollington/terma --skill skill-improver -a cursor2Manually: put the files in place
.cursor/skills/skill-improver/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bfollington/terma plugins/terma/skills/skill-improver2Manually: put the files in place
.github/skills/skill-improver/SKILL.md1Skills CLI (Vercel)
npx skills add bfollington/terma --skill skill-improver -a gemini-cli2Platform CLI
gemini skills install https://github.com/bfollington/terma --path plugins/terma/skills/skill-improverManually: put the files in place
.devin/skills/skill-improver/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bfollington/terma --skill skill-improver -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.