Validate Plugin

Full plugin directory validator combining structural checks and content grading.

Overview

Runs the complete validation pipeline against any plugin directory:

1. validate-all-plugins.sh

   for structural validation (plugin.json, file refs, permissions)

2. validate-skills-schema.py

   for content validation with 100-point grading

Prerequisites

• Python 3 with

  pyyaml

  installed

• jq

  available on PATH
• Run from the claude-code-plugins repository root

Instructions

1. Identify the target plugin directory (must contain

   .claude-plugin/plugin.json

   )
2. Run structural validation:

   ./scripts/validate-all-plugins.sh <plugin-directory>
   

3. Run content validation on any SKILL.md files found:

   python3 scripts/validate-skills-schema.py --verbose <path-to-SKILL.md>
   

4. If the plugin has commands or agents, validate those too:

   python3 scripts/validate-skills-schema.py --verbose
   

5. Report the combined results with per-skill 100-point grades

Output

Present results in this format:

Structural Validation:

• plugin.json: PASS/FAIL (list any invalid fields)
• File references: PASS/FAIL
• Script permissions: PASS/FAIL

Content Validation (per SKILL.md):

• Grade: A-F (score/100)
• Errors: list
• Warnings: list

Summary:

• Total errors / warnings
• Overall verdict: PASS or FAIL

Error Handling

• If plugin directory doesn't exist, report and exit
• If plugin.json is missing, report as structural failure
• If Python or jq not available, report as environment issue
• Continue validating remaining files even if one fails

Examples

Example 1: Validate a specific plugin

/validate-plugin plugins/skill-enhancers/skill-creator/

Example 2: Validate current directory

validate this plugin

Resources

• Anthropic Plugins Reference
• Anthropic Skills Spec