---

name: validate-plugin description: 'Validate a Claude Code plugin directory against the official Anthropic spec

and Intent Solutions enterprise standard. Runs structural validation (plugin.json

fields, file references, permissions) and content validation (SKILL.md grading,

command/agent frontmatter). Use when building a new plugin, preparing for

marketplace submission, or auditing existing plugins. Trigger with "validate

this plugin", "check plugin structure", "grade my plugin", "/validate-plugin".

' allowed-tools: Read, Bash(python3:), Bash(jq:), Bash(chmod:*), Glob, Grep version: 1.8.0 author: Jeremy Longshore jeremy@intentsolutions.io license: MIT user-invocable: true argument-hint: tags:

• skill-development
• audit
• validate-plugin compatibility: Designed for Claude Code

---

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