About self-repair
self-repair is a skill for checklist-based recovery of missing or invalid project state. Its repair demons fix canonical files, sidecar metadata, and boundary issues, log the repairs, and continue rather than failing.
Key features
- 01Detect missing or invalid state
- 02Repair canonical files
- 03Maintain sidecar metadata
- 04Check files against boundaries
- 05Log repairs and continue
Use cases
- 01Restore missing required files
- 02Repair missing metadata beside files
- 03Identify files outside defined boundaries
- 04Continue a workflow after state repair
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/self-repairin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
CARD.ymlCHECKLIST.yml.tmplGLANCE.ymlREADME.mdskill-snitch-report.mdDetails
From the project READMESelf Repair
Missing state triggers repair, not failure.
Checklist-based self-healing demons.
Important
NEVER-CRASH — The core principle. Repair instead of fail. Always.
The Principle
When something's wrong:
- Detect — Checklist finds missing/invalid state
- Repair — Demon creates/fixes what's needed
- Log — Document what was repaired
- Continue — Never crash, always converge
Contents
| File | Purpose |
|---|---|
| SKILL.md | Full protocol documentation |
| CHECKLIST.yml.tmpl | Checklist template |
Repair Demons
| Demon | Watches For |
|---|---|
checklist_repairer | Missing canonical files |
sticky_note_maintainer | Missing sidecar metadata |
membrane_keeper | Files outside boundaries |
The Intertwingularity
Self-repair is the immune system. It monitors everything.
graph LR
SR[🔧 self-repair] -->|monitors| SL[📜 session-log]
SR -->|monitors| WS[working-set.yml]
SR -->|creates| HOT[hot.yml / cold.yml]
SR -->|repairs| FILES[missing files]
SR -->|part of| KERNEL[kernel/self-healing]
Dovetails With
Sister Skills
| Skill | Relationship |
|---|---|
| session-log/ | Self-repair monitors log integrity |
| summarize/ | Triggered when context exceeds budget |
| honest-forget/ | Graceful memory decay |
Protocol Symbols
| Symbol | Link |
|---|---|
NEVER-CRASH | PROTOCOLS.yml |
REPAIR-DEMON | PROTOCOLS.yml |
ROBUST-FIRST | PROTOCOLS.yml |
BEST-EFFORT | PROTOCOLS.yml |
Kernel
- kernel/self-healing-protocol.md — Full specification
- schemas/agent-directory-schema.yml — What gets repaired
Navigation
| Direction | Destination |
|---|---|
| ⬆️ Up | skills/ |
| ⬆️⬆️ Root | Project Root |
| 📜 Sister | session-log/ |
Comments
Markdown supported