plugin-packager-validation
Plugin validation errors and fixes
When & Why to Use This Skill
The plugin-packager-validation skill is a specialized developer utility designed to streamline the creation and debugging of Claude plugins. It provides a comprehensive reference for common validation errors, such as path issues and schema mismatches, offering actionable fixes and essential debug commands. By ensuring compliance with the Claude plugin schema and directory rules, this skill helps developers build robust, error-free integrations and agentic tools.
Use Cases
- Troubleshooting 'Invalid path' errors by ensuring all relative paths in the plugin manifest correctly use the './' prefix.
- Fixing execution issues for hook scripts by identifying and applying the necessary 'chmod +x' permissions.
- Validating the integrity of the '.claude-plugin/plugin.json' file using jq to catch syntax errors and missing required fields like 'name' and 'version'.
- Verifying the directory structure of a plugin to ensure all agents, commands, and skills are located at the root and correctly referenced.
- Using specialized debug commands to audit hook scripts and component paths before packaging or deployment.
| name | plugin-packager-validation |
|---|---|
| description | Plugin validation errors and fixes |
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