Agent skill
plugin-packager-validation
Plugin validation errors and fixes
Install this agent skill to your Project
npx add-skill https://github.com/JamesPrial/claudefiles/tree/main/skills/plugin-packager/validation
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
plugin-packager
Package claudefiles components into a valid Claude Code plugin
plugin-packager-subset
Package language-specific subsets of claudefiles
plugin-packager-hooks
Handle hook scripts and paths for plugin packaging
go-concurrency
Go concurrency patterns. Routes to specific patterns.
go-sync-primitives
sync.WaitGroup and sync.Mutex patterns
go-context-cancellation
Context cancellation patterns for graceful shutdown
Didn't find tool you were looking for?