kintsugilisted
Install: claude install-skill Swastikbhat-lab/kintsugi
# Kintsugi
Repair defects in a codebase the way the craft repairs a cracked bowl — fill
the gaps, and only keep what survives being tested. This skill is the
generalized version of the loop that originally repaired web UI: instead of
measuring a rendered page, it measures **anything a check command can
report**.
The loop has five phases. Only one of them is allowed to be creative.
```
observe → diagnose → repair → verify → settle
```
## Quick start
The engine ships in this repo and boots itself. From **any** repo, with this
skill installed:
```bash
~/.claude/skills/kintsugi/scripts/run-loop.sh --source . --dry # survey, write nothing
~/.claude/skills/kintsugi/scripts/run-loop.sh --source . # repair
~/.claude/skills/kintsugi/scripts/run-loop.sh --source . --watch # keep repairing as it drifts
~/.claude/skills/kintsugi/scripts/run-loop.sh --install-agents # ship the observer/healer/critic/verifier subagents
~/.claude/skills/kintsugi/scripts/run-loop.sh --review --source . # CodeGuardian review fleet: security, bugs, deps, semantic — writes nothing
~/.claude/skills/kintsugi/scripts/run-loop.sh --selfcheck # verify the install: boots the engine, runs the fixture dry
```
`--watch` keeps the loop resident: it watches the repo and runs a pass a
couple of seconds after each change settles, ignoring its own writes so a
repair never re-triggers itself. `--interval <secs>` adds a periodic
re-check for drift that doesn't touch files.
`--review` runs the **