skill-updater
Updates skills during project work according to their contracts. Adds references, improves explanations, and refines examples while respecting skill boundaries. Use when discovering patterns, encountering edge cases, or finding better ways to explain skill concepts. Works with skills that have Skill Contracts defined by skill-contract-generator.
When & Why to Use This Skill
The skill-updater is a specialized workflow tool designed for Claude Code to systematically maintain and enhance AI agent capabilities. It provides a structured 5-step framework—Plan, Backup, Apply, Validate, and Document—to ensure that skill improvements are implemented safely, documented thoroughly, and verified against regressions, making it essential for developers managing complex agentic lifecycles.
Use Cases
- Iterative Skill Refinement: Systematically applying recommendations from code reviews or automated reviewers to improve the logic and efficiency of existing Claude skills.
- Documentation & UX Enhancement: Updating skill descriptions, adding quick-reference guides, and refining examples to improve the AI's performance and user clarity.
- Version Management & Safety: Creating backups and maintaining detailed update logs when transitioning skills through different versions (e.g., v1.0 to v1.1) to ensure traceability.
- Contract Validation: Ensuring that updates to a skill remain compliant with defined 'Skill Contracts' and do not introduce regressions in agent behavior.
| name | skill-updater |
|---|---|
| description | Apply improvements to Claude Code skills systematically. Workflow for planning updates, implementing changes, validating improvements, and documenting changes. Use when applying review recommendations, updating skills based on feedback, enhancing existing skills, or implementing systematic improvements across multiple skills. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash, WebSearch, WebFetch |
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.