Skill Reviewer

Review existing skills and generate actionable improvement suggestions using both inline patch/diff format and structured JSON output.

When to Use

• User explicitly requests review of a skill at a specific path
• User is drafting or creating a new skill (auto-trigger)
• After running uvx skills-ref validate to understand spec violations

Core Workflow

1. Load & Parse

Identify the skill path to review:

• Explicit: User provides skill path directly
• Auto-trigger: User mentions "new skill", "create skill", "draft skill" → review the SKILL.md being created