| 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 | <plugin-directory-path> |
| 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:
validate-all-plugins.sh for structural validation (plugin.json, file refs, permissions)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
-
Identify the target plugin directory (must contain .claude-plugin/plugin.json)
-
Run structural validation:
./scripts/validate-all-plugins.sh <plugin-directory>
-
Run content validation on any SKILL.md files found:
python3 scripts/validate-skills-schema.py --verbose <path-to-SKILL.md>
-
If the plugin has commands or agents, validate those too:
python3 scripts/validate-skills-schema.py --verbose
-
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
