# Workflow: Improve Skill

**Model tier**: Main/Haiku (gather), Opus (prioritize), varies (apply), Main (verify)

## When to use

- After task using skill and encountering friction
- Knowledge docs outdated or incomplete
- Periodic maintenance

## Inputs required

- **skill_path** - Path to skill
- **friction_notes** (optional) - Specific friction points

## Task document

Create: `.claude/plugin-data/skill-architect/tasks/improve-skill-<skill-name>-<date>.md`

---

## Subtasks

### 1. Gather friction data

Subagent: Main or haiku.

**Do:**
- Check `.claude/plugin-data/skill-architect/tasks/` for friction notes
- Ask user for pain points
- List in task doc

---

### 2. Prioritize improvements

Subagent: opus.

**Do:**
- Review friction notes
- Filter one-time issues
- Prioritize by frequency/impact
- Write prioritized list to task doc

---

### 3. Apply improvements

Subagent: Varies by complexity.
Read: Files being modified.

**Do:**
- For each improvement: read file, make targeted edit, document change
- Update task doc with changes

---

### 4. Verify and reflect

Subagent: Main.

**Do:**
- Spot-check modified files
- Verify reference.md files accurate
- Report summary