Skill Reviewer

Overview

skill-reviewer identifies specific, actionable improvements for Claude Code skills. While review-multi provides comprehensive scoring (1-5), skill-reviewer focuses on finding and documenting improvement opportunities.

Purpose: Improvement discovery for existing skills

Integration with review-multi:

review-multi: Comprehensive scoring, production readiness
skill-reviewer: Improvement hunting, enhancement focus
Use together: review-multi scores, skill-reviewer improves

The 4 Review Operations:

Content Enhancement Review - Find content that could be clearer, more complete, better examples
Usability Improvement Review - Identify user experience enhancements
Integration Opportunity Review - Find integration and composition opportunities
Efficiency Improvement Review - Identify ways to make skill more efficient

When to Use

Finding improvements for good skills (score 4-5 but could be better)
Post-deployment enhancement planning
Continuous improvement iterations
User feedback incorporation
Periodic skill refreshes

Operations

Operation 1: Content Enhancement Review

Focus: Better examples, clearer explanations, additional scenarios

Process:

Review examples - could any be more concrete/helpful?
Check explanations - any unclear sections?
Review scenarios - missing important use cases?
Check completeness - any gaps?

Output: List of content improvements with priorities

Operation 2: Usability Improvement Review

Focus: Easier to use, faster to learn, more effective

Process:

Test actual usage - where's friction?
Check learning curve - could it be easier?
Review navigation - could it be clearer?
Check Quick Reference - could it be more helpful?

Output: UX improvement opportunities

Operation 3: Integration Opportunity Review

Focus: Better integration with other skills, new composition possibilities

Process:

Review skill dependencies - could integration be smoother?
Check for workflow opportunities - could this compose with others?
Look for synergies - which skills work well together?
Identify gaps - what's missing for good integration?

Output: Integration enhancement opportunities

Operation 4: Efficiency Improvement Review

Focus: Faster to use, better automation, reduced effort

Process:

Check for automation opportunities
Review process efficiency - any unnecessary steps?
Look for shortcuts - quick paths for common cases?
Check token efficiency - context optimization possible?

Output: Efficiency improvement opportunities

Quick Reference

Operation	Focus	Output
Content Enhancement	Examples, clarity, scenarios	Content improvements
Usability Improvement	UX, learning curve, friction	UX enhancements
Integration Opportunity	Composition, synergies	Integration ideas
Efficiency Improvement	Automation, speed	Efficiency gains

Use with: review-multi (scoring) + skill-reviewer (improvements) + skill-updater (apply changes)

skill-reviewer finds improvement opportunities to make good skills even better.