---

name: plugin-packager-validation description: Plugin validation errors and fixes

Validation Error Reference

Debug Commands

Copy# Validate JSON
jq . .claude-plugin/plugin.json

# List all components
find . -type d \( -name agents -o -name commands -o -name skills -o -name hooks \) -exec ls {} \;

# Check hook scripts
find hooks -type f -exec file {} \;

Full Schema Reference

Copy{
  "name": "REQUIRED",
  "version": "REQUIRED (semver)",
  "description": "optional",
  "author": {"name": "", "email": "", "url": ""},
  "commands": "./commands/ OR [array]",
  "agents": "./agents/ OR [array]",
  "skills": "./skills/ OR [array]",
  "hooks": "./hooks/hooks.json OR [array] OR {inline}"
}

Rules

1. All paths relative, starting with ./
2. Only plugin.json in .claude-plugin/
3. Components at plugin root
4. Arrays for multiple paths