improvelisted
Install: claude install-skill assafkip/kipi-system
# Improve: an outside idea, judged against the system that exists
Plan item 2d of the morning-brief overhaul (Bloom's `improve` pass). The
founder pastes an idea. This skill answers one question: does it change how
the SYSTEM works, and is that change already here?
## The two halves
1. **Deterministic (this skill must run it, never reason from memory):**
```bash
python3 plugins/kipi-core/skills/improve/scripts/improve_ground.py --target <rule|lint|hook|trigger|context|skill|prompt|test|script|job> "<idea in one sentence>"
```
It prints a JSON verdict with `cites` (lessons paths or named files) and a
`corpora` report saying which lessons directories were read, missing or
unreadable. Exit 0 for `already-built` / `adopt`, 2 for `skip`.
Set `KIPI_LESSONS_CORPORA=/path/one:/path/two` to ground against more than
this instance's corpus; the report names each one either way.
2. **Judgment (the skill):** read what the script cited. Then write the
critique in this shape:
- The idea, in one sentence, as a SYSTEM change (a stage, a trigger, a
rule, a context entry). If it cannot be phrased that way it is roadmap,
and the verdict is skip regardless of how good the idea is.
- What already exists: the cited file or lesson, opened, with the line that
covers it. Not "we have something like that".
- Verdict: `already-built` (name the file), `adopt` (name the smallest
change and the check that would prove it), or `skip` (name the rea