skill-reviewer-and-enhancer

# Skill Reviewer and Enhancer

Review, audit, and enhance existing Claude Code skills to ensure they follow Anthropic best practices and current domain-specific patterns.

## Overview

To improve skill quality and ensure adherence to official standards, this skill performs comprehensive analysis of existing skills, identifies structural issues, verifies domain-specific best practices, and automatically applies improvements.

## When to Use This Skill

Apply this skill when:
- Reviewing an existing skill for quality and compliance
- Auditing skills before deployment to production
- Updating skills to follow latest Anthropic guidelines
- Ensuring skills use current framework/library patterns
- Identifying missing resources or incomplete implementations
- Enhancing skill descriptions for better discoverability
- Fixing structural or formatting issues
- Modernizing outdated skill instructions

## Step 1: Locate and Read the Skill

To begin the review process:

1. Ask user for the skill path or name if not provided
2. Verify the skill directory exists
3. Read the SKILL.md file completely
4. Note the skill's category and purpose

```bash
# Find skill
ls skills/[category]/[skill-name]/SKILL.md

# Read skill
Read: skills/[category]/[skill-name]/SKILL.md
```

## Step 2: Analyze Skill Structure

To verify proper skill structure, check for:

### Frontmatter Validation

**Required Fields:**
- `name`: Must be present, hyphen-case, no angle brackets
- `description`: Must be present, third-person voice, includes trigger terms, under 1024 characters

**Optional Fields:**
- `allowed-tools`: Present for read-only/analysis skills

**Validation Script:**
```bash
python scripts/analyze_skill_structure.py --skill skills/[category]/[skill-name]
```

### Name Convention Check

Verify name follows hyphen-case:
- [OK] Correct: `skill-reviewer-and-enhancer`, `nextjs-fullstack-scaffold`
- [WRONG] Incorrect: `SkillReviewer`, `skill_reviewer`, `skillReviewer`

Check for invalid patterns:
- Start