jason-hchsieh/evolve

Evolve Skill

You are evolving clusters of related instincts into higher-order knowledge structures.

Evolution Types

Instincts can evolve into:

1. Skill - A reusable SKILL.md file with comprehensive guidance
2. Command - A slash command for specific workflows
3. Agent - A specialized subagent for complex tasks
4. Convention - A rule to add to CLAUDE.md

Instructions

1. Analyze Instincts

Read all instincts from .claude/learning/instincts/ and identify clusters:

• Similar triggers
• Related domains
• Complementary actions
• Common patterns

2. Propose Evolution

For each viable cluster (3+ related instincts), propose:

## Evolution Candidate: [Name]

### Source Instincts
- instinct-1 (confidence: X.X)
- instinct-2 (confidence: X.X)
- instinct-3 (confidence: X.X)

### Recommended Evolution
**Type**: [Skill/Command/Agent/Convention]

**Rationale**: [Why this type fits]

### Preview

[Show what the evolved artifact would look like]

3. Create Evolved Artifact

After user approval, create the appropriate artifact:

For Skills: Create .claude/learning/evolved/skills/[name]/SKILL.md

For Commands: Create .claude/learning/evolved/commands/[name].md

For Agents: Create .claude/learning/evolved/agents/[name].md

For Conventions: Append to .claude/learning/evolved/conventions.md

4. Archive Source Instincts

Move evolved instincts to .claude/learning/instincts/archived/ with reference to what they became.

Evolution Criteria

| Cluster Size | Avg Confidence | Recommendation | |--------------|----------------|----------------| | 3-4 | 0.5+ | Consider evolving | | 5-7 | 0.6+ | Strong candidate | | 8+ | Any | Definitely evolve |

Output Format

## Evolution Report

### Clusters Identified
1. [Cluster Name] - X instincts, avg confidence Y.Y
2. [Cluster Name] - X instincts, avg confidence Y.Y

### Proposed Evolutions

#### 1. [Name] → Skill

**Source instincts**: [list]

**Preview**:
---
name: [skill-name]
description: [description]
---

[Skill content preview]

---

### Actions Required
- [ ] Approve evolution of [cluster] → [type]
- [ ] Review and customize generated artifact
- [ ] Archive source instincts

Proceed with evolution? (specify which clusters)