refactoring-skills

# Refactoring Skills

Systematically analyze all skills and apply refactoring for quality and consistency.

## Process

### 1. Invoke Architecture Advisor

Use the `agent-architect` skill to get a holistic view of the current skill landscape.

### 2. Discover All Skills

```bash
find . -name "SKILL.md" -type f
```

### 3. Analyze Each Skill

For each skill, classify:

| Status | Action |
|--------|--------|
| **Keep** | Well-structured, unique purpose |
| **Refactor** | Has issues but valuable |
| **Merge** | Overlaps with another skill |
| **Extract** | Has conventions shared by other skills → move to Rules |
| **Delete** | Redundant or unused |

### 4. Apply Refactoring

**For skills to refactor:**
Use the `writing-skills` skill to guide improvements.

**For skills to merge:**
- Identify the primary skill
- Consolidate unique content
- Delete the redundant skill

**For shared conventions to extract:**
- Use `writing-rules` skill to create rule in `.claude/rules/`
- Remove duplicated convention from each skill

**For skills to delete:**
- Confirm no dependencies
- Remove entire skill directory

### 5. Validate Results

```bash
python3 skills/write-skill/scripts/validate_skill.py <skill-path>
```

### 6. Generate Report

```markdown
## Refactoring Summary

### Skills Analyzed: N

### Actions Taken:
- Kept: X skills
- Refactored: Y skills
- Merged: Z skills
- Extracted to Rules: A conventions
- Deleted: W skills

### Changes Made:
- [skill-name]: [action taken]
```