Skill Updater

Overview

skill-updater provides systematic workflow for applying improvements to existing Claude Code skills based on review findings, user feedback, or identified opportunities.

Purpose: Systematic skill improvement and enhancement

Integration:

review-multi → identifies improvements
skill-reviewer → finds opportunities
skill-updater → applies changes systematically
skill-validator → validates changes

Update Workflow (5 steps):

Plan Updates - Review recommendations, prioritize, plan changes
Backup Skill - Save current version before changes
Apply Changes - Implement improvements systematically
Validate Changes - Ensure improvements effective, no regressions
Document Updates - Record what changed and why

When to Use

Applying review-multi recommendations
Implementing user feedback
Enhancing skill based on skill-reviewer findings
Systematic improvements across skills
Version updates (v1.0 → v1.1)

Update Workflow

Step 1: Plan Updates

Process:

Gather improvement recommendations (from reviews, feedback)
Prioritize: Critical → High → Medium → Low
Estimate effort per improvement
Plan update sequence
Set success criteria

Step 2: Backup Skill

Process:

# Create backup
cp -r .claude/skills/skill-name .claude/skills/skill-name.backup-$(date +%Y%m%d)

# Or use git
git add .claude/skills/skill-name
git commit -m "Backup before updates"

Step 3: Apply Changes

Process:

Start with highest priority
Make one improvement at a time
Test after each change
Mark as complete
Move to next

Step 4: Validate Changes

Process:

Run skill-validator (structure, content, pattern)
Compare before/after (metrics, quality)
Test in real scenario (usability)
Verify no regressions

Step 5: Document Updates

Process:

## Updates Log

### Version 1.1 (2025-11-07)

Changes:
- Added Quick Reference section (user experience)
- Enhanced examples in Operation 2 (clarity)
- Fixed vague validation criteria (quality)

Impact:
- Usability improved (Quick Reference)
- Clarity improved (better examples)
- Validation more measurable

Validation: Passed skill-validator, structure score 5/5

Quick Reference

Update Workflow

Plan → Backup → Apply → Validate → Document

Common Update Types

Add Quick Reference (UX improvement)
Enhance examples (clarity)
Fix validation criteria (make specific)
Add error handling (completeness)
Optimize structure (progressive disclosure)

skill-updater enables systematic, validated improvement of existing skills.