Aeon Skill Repair
Auto-diagnose and fix a failing or degraded installed skill.
Install
npx skills add BankrBot/skills --skill aeon-skill-repair -g -a claude-code -y- Repository
- BankrBot/skills1.2k
- Category
- AI and agents
- Updated
- 4d ago
- License
- See repository
- Context cost
- Lightabout 692 tokens
- Runs scripts
- No, instructions only
What it does
Auto-diagnose and fix a failing or degraded installed skill. Reads the SKILL.md plus recent error output, classifies the failure (api-change / rate-limit / timeout / sandbox-limitation / prompt-bug / output-format / missing-secret / config), applies the smallest fix that addresses the root cause, and attaches a verification recipe. Minimum-edit principle, never auto-applies high-risk changes. Triggers: "fix this skill", "skill X is broken", "diagnose this failure", "the output of X looks wrong".
aeon-skill-repair
Targeted repair for one failing skill. Build a diagnostic dossier, classify the failure, apply the matching playbook, attach a verification recipe.
Inputs
| Param | Description |
|---|---|
target | Skill name or SKILL.md path. Required. |
error_output | Recent failed output (paste from run log). Required if not auto-detectable. |
mode | repair (default) or dry-run (diagnose only). |
Diagnosis sources
- The skill file (frontmatter, declared sources, env-var references).
- Error output signature (HTTP codes, common API errors, rate-limit hits, refusal markers).
- Source liveness, WebFetch on referenced URLs to detect 404s, redirects, schema changes.
- Frontmatter integrity (valid YAML).
Failure categories and fix scope
| Category | Detection | Fix scope |
|---|---|---|
api-change | 404/410, schema mismatch | Update endpoints/payload/headers per live spec. Cite the spec URL. |
rate-limit | 429, "too many requests" | Add backoff or fallback endpoint. Never raise the limit. |
timeout | Killed mid-run, partial output | Stage the work, add early-return on partial success. |
sandbox-limitation | Auth-bearing curl fails | Convert to prefetch / postprocess pattern. |
prompt-bug | Hallucination, refusal, missing required section | Minimum-edit specificity insertion. < 30 lines diff. |
output-format | Output passes execution but fails downstream parser | Edit until next run satisfies the failing assertion. |
missing-secret | "API key missing", env var unset | No code change. Name the missing var for the operator. Exit REPAIR_DIAGNOSED_NO_FIX. |
config | Bad input config (watchlist, list file) | Fix obvious shape errors. Never invent entries. |
unknown | None of the above | Don't edit blindly. Append dossier to repair-notes, exit REPAIR_DIAGNOSED_NO_FIX. |
