skill-improver

Installation
SKILL.md

Skill Improver

Skills improve from friction, not from review. The question is never "could this skill be better" — everything could. It is what actually went wrong, and would a change to a skill have prevented it?

Most friction should not become a skill change. It was environmental, or a one-off, or already covered by something that simply did not fire. Changing skills in response to noise is how a sharp set becomes a bloated one, and bloat is the failure mode that matters here — every unnecessary line makes the necessary ones less visible.

Start from what actually happened

Not "how did that go" but: where specifically was there confusion, repetition, a wrong turn taken and reversed, a workaround invented, or a correction from the user?

Each of those is a candidate. For each, the question that decides everything: would a skill have prevented this, and which one?

Usually the answer is one of:

  • A skill existed and did not fire. The problem is the description, not the body. Fix the trigger.
  • A skill fired and was ignored or misapplied. The content is not landing — usually buried, hedged, or stated so generally it did not connect to the situation.
  • A skill was right but incomplete in a way that recurs. A real gap.
  • No skill covers this, and it will happen again. Possibly a new skill.
  • Nothing would have helped. Environmental, novel, or genuinely one-off. This is the most common answer and it is a fine one.
Installs
59
GitHub Stars
52
First Seen
Jan 24, 2026