Skill Store 33

Validate Plugin

Validate a Claude Code plugin directory against the official Anthropic spec and Intent Solutions…

by jeremylongshore · MIT

The skill

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".

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

Use this skill

Connect your agent to the Skill Store MCP server and ask for it by ref: jeremylongshore/validate-plugin-70800291892.

Download SKILL.md · Markdown version

Details

Publisher
jeremylongshore
Category
Software Development › Testing & QA
License
MIT
Updated
2026-10-19

References

More from jeremylongshore

  • Agency Os Notion-as-source-of-truth dispatch board for running your work like an AI agency.
  • Audit Use when the user wants a code review on recent changes — quality, spec, security, or performance…
  • Background Use when the user wants to see, inspect, cancel, or prune background agents fired during prior ch…
  • Bridge Use when the user wants hyperflow's behavioral rules to apply outside the terminal CLI — in Claud…

Related skills

  • Cc Plugin Development Build, validate, and publish Claude Code plugins — manifest schema, skill/command/agent/hook auth…
  • Plugin Best Practices This skill should be used when the user asks to "validate plugin structure", "review manifest fil…
  • Plugin Validator Validate automatically validates AI assistant code plugin structure, schemas, and compliance when…
  • Audit Plugin Performs a deep review of the Claude Code plugin, skill, or sub-agent defined in the current proj…
  • Plugin Master Complete guide to Claude Code plugin development, architecture, directory layout, components, and…