self-evolutionlisted
Install: claude install-skill richfrem/agent-plugins-skills
# Self-Evolution Skill
**Trigger:** Any tool call or subprocess returns a failure that may be caused by a stale
selector, missing helper, or broken script — and the fix is within the agent's allowed
edit boundaries.
**Core principle:** The agent does not just retry — it learns. Every fix either patches
a helper (so the failure can't recur) or updates a reference file (so future agents
avoid the same dead end). Fixes that aren't recorded are not fixes; they are patches
waiting to become the same bug again.
---
## Phase 0 — Read the Repo Profile
Before doing anything else, locate and read the repo's self-evolution profile:
```
<repo-root>/plugins/<plugin>/references/self-evolution-profile.md
```
If no profile exists for the current repo/plugin, create a minimal one now using the
template in Phase 0.1 below, then continue.
The profile defines:
- **Allowed edit directories** — the only dirs the agent may edit autonomously
- **Error pattern → tier classification table** — maps known error signatures to Gap/Failure/Regression
- **Domain playbook location** — where reference files ("The Map") live
- **Evolution log path** — where to append the fix record
### Phase 0.1 — Bootstrap Profile (if missing)
If no profile exists, write one at `<plugin>/references/self-evolution-profile.md`:
```markdown
# Self-Evolution Profile — <Plugin Name>
## Allowed Edit Directories
# List dirs the agent may edit autonomously (relative to repo root)
## Error Pattern Classification
| Pattern