Skip to content

Plugin Validator

The Plugin validator checks .claude-plugin/plugin.json manifest files for schema compliance, versioning, and component references.

What It Checks

  • plugin.json schema validation
  • Semantic versioning format
  • Required fields (name, version, description)
  • Skill, agent, and hook references
  • Component file existence
  • Directory structure
  • marketplace.json schema

Rules

This validator includes 12 rules. See the Plugin rules category for the complete list.

RuleSeverityDescription
plugin-name-requirederrorPlugin name is required
plugin-version-requirederrorPlugin version is required
plugin-invalid-versionerrorInvalid semantic version
plugin-missing-fileerrorReferenced file not found
plugin-invalid-manifesterrorInvalid manifest schema

CLI Usage

bash
claudelint validate-plugin
claudelint validate-plugin --verbose

See Also