Validate plugin
'Validate a Claude Code plugin directory against the official Anthropic specFrom its SKILL.md
npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill validate-pluginAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.8 KB, 468 tokens by cl100k_base, as published. Nobody here has run it
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.shfor structural validation (plugin.json, file refs, permissions)validate-skills-schema.pyfor content validation with 100-point grading
Prerequisites
- Python 3 with
pyyamlinstalled jqavailable 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
validate this plugin
Resources
What ships with it: 1 file
13.3 KB alongside SKILL.md
references/
- plugin-schema.md13.3 KB