---

description: Validate an FTC skill plugin structure and content argument-hint: <skill-name> allowed-tools: Read, Glob, Grep, Bash(jq:*)

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