Agent skill · software engineering · jeremylongshore
plugin-validator
Validate automatically validates AI assistant code plugin structure,
Why this skill is useful
Adds a comprehensive validation script for AI assistant plugins that ensures compliance with specific standards and generates detailed reports.
What it needs
Requires grep, jq installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
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 1. Identify the target plugin path from context or user request. Default to the current working directory if the path contains a .claude-plugin/ subdirectory. 2. Validate required files exist (see ${CLAUDESKILLDIR}/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/). 3. 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). 4. Validate frontmatter in all component files: Commands (commands/.md): require name, description, model (one of sonnet, opus, haiku). Agents (agents/.md): require name, description, model. Skills (skills//SKILL.md): require name, description; allowed-tools optional but validated against the allowed tools list if present. 5. Validate directory structure matches the expected hierarchy (see ${CLAUDESKILLDIR}/references/validation-checks.md for the complete structure diagram). 6. Check script permissions: find all .sh files and verify they have execute permission. Report any that lack it with a fix command. 7. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/plugin-validator