Self Repair Skill | Agent Skills

Self 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

| 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/ |

Agent Skills: Self Repair

Install this agent skill to your local

Skill Files