SKILL.md
Validation Error Reference
| Error |
Fix |
| Invalid path |
Add ./ prefix |
| Script not executable |
chmod +x <script> |
| Invalid JSON |
Run jq . .claude-plugin/plugin.json |
| Missing field |
Add name and version |
| Component not found |
Verify path exists |
Debug Commands
# 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
{
"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
- All paths relative, starting with
./
- Only plugin.json in
.claude-plugin/
- Components at plugin root
- Arrays for multiple paths
