Skip to content

/validate-plugin

Validates Claude Code plugin manifest files (plugin.json). Use when user asks to "check my plugin.json", "validate plugin.json", "plugin errors", or "why isn't my plugin loading". Validates JSON syntax, required fields (name, version, description), semantic versioning, and skill

From plugin
claudelint
129 skills13 agents1 command1 hook
Install
$ npx -y skills add pdugan20/claudelint --skill validate-plugin --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/validate-plugin

Context preview

The summary Claude sees to decide when to auto-load this skill.

Validates Claude Code plugin manifest files (plugin.json). Use when user asks to "check my plugin.json", "validate plugin.json", "plugin errors", or "why isn't my plugin loading". Validates JSON syntax, required fields (name, version, description), semantic versioning, and skill

SKILL.md

validate-plugin.SKILL.md
name: validate-plugin
description: Validates Claude Code plugin manifest files (plugin.json). Use when user asks to "check my plugin.json", "validate plugin.json", "plugin errors", or "why isn't my plugin loading". Validates JSON syntax, required fields (name, version, description), semantic versioning, and skill file references.
version: 1.0.0
argument-hint: "[flags]"
allowed-tools:
  - Bash(claudelint:*)

Validate Plugin Manifests

Runs `claudelint validate-plugin` to validate `.claude-plugin/plugin.json` files.

Usage

claudelint validate-plugin $ARGUMENTS

Options

  • `--path <path>` - Custom path to plugin.json
  • `--verbose` - Show detailed output
  • `--warnings-as-errors` - Treat warnings as errors

What Gets Validated

  • JSON syntax
  • Required fields (name, version, description)
  • Semantic versioning (x.y.z format)
  • Skill file references (checks if referenced skills exist)
  • Optional fields (homepage, repository, author, license)

Examples

claudelint validate-plugin
claudelint validate-plugin --path /path/to/plugin.json

See Also

  • [validate-all](../validate-all/SKILL.md) - Run all validators
Ships withclaudelint

A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.

Get the whole plugin, auto-invoked

Other skills on claudelint.