Agent skill
plugin-packager-validation
Plugin validation errors and fixes
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/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.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?