avibebuilder/claude-prime / .claude/skills/self-evolve
self-evolve
VerifiedThe single config quality skill. Two modes: (1) Default — review/wire pending self-improvement proposals. (2) Audit — analyzes skills, rules, CLAUDE.md, project refs, hooks, and agents against the actual codebase to find inaccuracies, trigger overlaps, stale references, and weak rules, then fixes them. Trigger on 'self-evolve', 'evolve', 'config health check', 'audit config', 'check claude setup', 'apply this rule', 'reorganize rules', 'ok' (when proposals are pending). NOT for improving individual skills (use skill-creator), diagnosing code bugs (use diagnose), or fixing broken code (use fix).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.4 KB |
| references/audit-guide.md | markdown | 2.6 KB |
| references/quality-dimensions.md | markdown | 1.3 KB |
references/quality-dimensions.md
View on GitHub# Self-Evolve Checklists
Non-obvious traps and mechanical checks only. Nothing Claude would do anyway.
## Mechanical Checks
### Reference integrity
```bash
# In a skill directory — verify all referenced files exist
grep -oE '(references|workflows|scripts|templates)/[^\s\)]+' SKILL.md | while read p; do
[ -e "$p" ] || echo "BROKEN: $p"
done
# In project root — verify CLAUDE.md on-demand references exist
grep -oE '\./[^\s\)]+\.md' CLAUDE.md | while read p; do
[ -e "$p" ] || echo "BROKEN: $p"
done
```
## Staleness Signals
- `git log --oneline -5 -- src/database/` shows heavy churn but database skill unchanged → likely stale
- New directory `src/grpc/` appeared but no skill covers it → gap
- `git log --diff-filter=R -- src/lib/db.ts` shows rename but skill still references old path → broken
- Dependency major version bumped (React 18→19) but skill references old patterns → outdated
## Conflict Resolution Priority
When the same fact is stated differently across layers:
- **Rules win over skills** — rules are guardrails, wrong code if missed
- **Project refs win over CLAUDE.md** — refs are more detailed, CLAUDE.md is just an entry point
- **Orphaned on-demand refs are invisible** — if a reference file exists but CLAUDE.md doesn't point to it, agents will never load it
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |