Skills

Skill Repair

Diagnose and fix failing or degraded skills automatically - systemic-first triage...

Install

npx skills add aeonfun/aeon --skill skill-repair -g -a claude-code -y
Repository
aeonfun/aeon787
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Diagnose and fix failing or degraded skills automatically - systemic-first triage, per-category playbooks, and a verification plan

<!-- autoresearch: variation D, systemic-first triage + per-category playbooks + verification (folds A's regression hunter, B's structured PR + risk class + verdict, C's exit taxonomy + preflight + cooldown) -->

${var}, Skill name to repair. If empty, runs systemic triage and picks the worst fixable target. ${var} modifiers: prefix dry-run: to diagnose only without writing a PR (e.g. dry-run:digest).

Today is ${today}. Your task is to diagnose and repair the worst-impact failing or degraded skill, preferring a single shared fix over N per-skill patches when failures cluster.

Phases

PREFLIGHT → TRIAGE → DIAGNOSE → REPAIR → VERIFY → LOG

Stop early at the appropriate exit code if any phase finds nothing actionable.

Exit taxonomy

Pick exactly one before notifying.

CodeMeaning
REPAIR_OK_FIXEDPer-skill fix applied, PR opened
REPAIR_OK_SYSTEMICShared root cause across N skills, single shared fix or shared issue filed
REPAIR_DIAGNOSED_NO_FIXRoot cause known but requires operator action (e.g. missing secret, upstream API down). Issue updated, no PR
REPAIR_NO_TARGETSAll tracked skills healthy and no open fixable issues
REPAIR_DRY_RUNvar=dry-run:NAME, diagnostic only, no PR
REPAIR_BLOCKEDPreflight failed (gh auth, missing files) or cooldown active

1. PREFLIGHT

Bail early with REPAIR_BLOCKED (and notify with the reason) if any of these fails:

  • gh auth status succeeds.
  • memory/cron-state.json exists and parses as JSON.
  • memory/issues/INDEX.md exists. If absent, bootstrap a minimal one (Open + Resolved tables, no rows).
  • memory/state/skill-repair-history.json exists. If absent, create {}.
Read the whole SKILL.md on GitHub

More in Engineering