What problem does it solve?
This Skill eliminates common failures and frustration when building Claude Code plugins, which often break due to incorrect directory layouts, invalid plugin.json manifests, or misorganized components that fail auto-discovery.
Core Features & Use Cases
- Full Plugin Architecture Reference: Covers standard directory structure, required and optional plugin.json fields, component organization for commands, agents, skills, and hooks, and auto-discovery rules.
- Portable Path Guidance: Teaches correct use of the ${CLAUDE_PLUGIN_ROOT} environment variable to avoid path resolution errors across operating systems, installation methods, and user environments.
- Scalable Organization Patterns: Provides advanced patterns for large, team-maintained plugins, including categorized component directories, shared utility libraries, and multi-environment configuration management.
- Use Case: A developer building a team-wide DevOps automation plugin can use this skill to correctly structure their CI commands, Kubernetes management agents, and security hooks, ensuring all components load automatically for every team member.
Quick Start
Use the Plugin Structure skill to build a new Claude Code plugin with the correct directory layout, valid manifest configuration, and properly organized components for your specific use case.