# Plugin Packager Validation

> Plugin validation errors and fixes

- Skill: `majiayu000/plugin-packager-validation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/plugin-packager-validation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/plugin-packager-validation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/plugin-packager-validation

---


# 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

```bash
# 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

```json
{
  "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