| name | plugin-validator |
| description | Validate automatically validates AI assistant code plugin structure, schemas, and compliance when user mentions validate plugin, check plugin, or plugin errors. runs comprehensive validation specific to AI assistant-code-plugins repository standards. Use when validating configurations or code. Trigger with phrases like 'validate', 'check', or 'verify'.
|
| allowed-tools | Read, Grep, Bash(cmd:*) |
| version | 2.19.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | MIT |
| tags | ["example","compliance","plugin-validator"] |
| compatibility | Designed for Claude Code |
Plugin Validator
Overview
Validates Claude Code plugin structure, JSON schemas, frontmatter format, security compliance, and marketplace catalog consistency. Runs the same checks as the CI pipeline to catch issues before committing.
Prerequisites
- Read access to the target plugin directory and repository-level
.claude-plugin/marketplace.extended.json
jq installed for JSON validation (jq empty <file>)grep and find available on PATH for pattern scanning./scripts/validate-all-plugins.sh available at the repository root
Instructions
- Identify the target plugin path from context or user request. Default to the current working directory if the path contains a
.claude-plugin/ subdirectory.
- Validate required files exist (see
${CLAUDE_SKILL_DIR}/references/validation-checks.md):
.claude-plugin/plugin.json present and valid JSON.README.md present and non-empty.LICENSE file present.- At least one component directory exists (
commands/, agents/, skills/, hooks/, or mcp/).
- Validate
plugin.json schema:
- Confirm all required fields:
name (kebab-case), version (semver x.y.z), description, author.name, author.email, license, keywords (array, minimum 2).
- Reject any fields not in the allowed set (
name, version, description, author, repository, homepage, license, keywords).
- Validate frontmatter in all component files:
- Commands (
commands/*.md): require name, description, model (one of sonnet, , ).
