validate-plugin

Validate Plugin

Validate that a plugin follows the correct Claude Code plugin format.

When to use

After creating or modifying a plugin, run validation to catch structural issues before publishing.

Checks performed

1. Directory structure — .claude-plugin/plugin.json exists at plugin root
2. plugin.json schema — required fields present (name, description, version)
3. Skills — each skill in plugin.json.skills has a matching skills/<name>/SKILL.md
4. Commands — each command in plugin.json.commands has a matching commands/<name>.md
5. Agents — each agent in plugin.json.agents has a matching agents/<name>.md
6. SKILL.md frontmatter — each skill has name, description, and allowed-tools
7. Agent frontmatter — each agent has name, description, and model
8. No files in wrong locations — skills/commands/agents not inside .claude-plugin/
9. MCP tool references — tools in allowed-tools are valid mcp__hyrex__* identifiers

Steps

1. Read the plugin's plugin.json
2. For each skill, command, and agent declared, verify the file exists
3. For each SKILL.md, verify frontmatter has required fields
4. For each agent .md, verify frontmatter has required fields
5. Report pass/fail for each check with actionable fix suggestions