Validate Skill Command

Validates that an FTC skill plugin follows marketplace requirements and best practices.

Usage

/validate-skill <skill-name>

Arguments:

• skill-name: Name of the skill to validate (must exist in plugins/)

Examples

/validate-skill pedro-pathing
/validate-skill rev-hub

Validation Checks

Structure Checks

• plugins/<skill-name>/ directory exists
• plugins/<skill-name>/plugin.json exists and is valid JSON
• plugins/<skill-name>/skills/<skill-name>/ directory exists
• plugins/<skill-name>/skills/<skill-name>/SKILL.md exists

plugin.json Checks

• Has name field matching directory name
• Has description field (non-empty)
• Has version field (semver format)
• Has license field
• Has tags array with "ftc"
• Has compatibility.agents array

SKILL.md Frontmatter Checks

• Has YAML frontmatter (starts with ---)
• Has name field matching directory name
• Has description field (non-empty, < 1024 chars)
• description includes WHAT the skill does
• description includes WHEN to use it (trigger words)
• Has license field
• Has metadata.category field
• Has metadata.version field

Content Quality Checks

• SKILL.md is under 500 lines
• Has "Quick Start" or "## Quick" section
• Has code examples (java or kotlin blocks)
• Has "Anti-Pattern" or "Don't" section
• No [TODO: ...] placeholders remaining
• No hardcoded file paths from template

marketplace.json Check

• Skill is listed in .claude-plugin/marketplace.json
• Entry has correct path field

Script Checks (if scripts/ exists)

• All .sh files are executable
• All .py files are executable
• Scripts have shebang line

Output Format

Report results as:

Validating skill: <skill-name>

Structure:
  ✓ plugin.json exists
  ✓ SKILL.md exists
  ✗ Missing scripts/ directory (optional)

plugin.json:
  ✓ Valid JSON
  ✓ Name matches directory
  ✗ Missing 'ftc' in tags

SKILL.md:
  ✓ Valid frontmatter
  ✓ Description includes WHAT
  ✗ Description missing WHEN triggers
  ✓ Under 500 lines (127 lines)

Content:
  ✓ Has Quick Start section
  ✓ Has code examples
  ✗ Missing Anti-Patterns section
  ✗ Contains [TODO: ...] placeholders

marketplace.json:
  ✓ Skill is registered

Summary: 8/12 checks passed

Severity Levels

• Error (✗): Must fix before submitting PR
• Warning (⚠): Should fix, but not blocking
• Info (ℹ): Suggestion for improvement

Errors (Must Fix)

• Missing required files (plugin.json, SKILL.md)
• Invalid JSON
• Name mismatch between folder and frontmatter
• Empty description
• Not in marketplace.json

Warnings (Should Fix)

• Description missing WHEN triggers
• No Anti-Patterns section
• SKILL.md over 500 lines
• Missing 'ftc' tag
• [TODO: ...] placeholders remaining

Info (Suggestions)

• No scripts/ directory
• Could add more code examples
• Consider adding TROUBLESHOOTING.md