Plugin Structure
This skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.
Security Assessment
About Plugin Structure
The Plugin Structure skill provides essential guidance for users looking to create, scaffold, or understand plugins within the Claude Code ecosystem. This skill addresses common queries related to plugin structure, including how to set up the necessary configuration files, organize components effectively, and ensure proper integration with the Claude Code framework. By following the standardized directory layout and configuration best practices outlined in this skill, users can develop plugins that are both maintainable and compatible with the automatic discovery features of Claude Code.
FAQ
What is the required structure for a Claude Code plugin?
A Claude Code plugin must follow a specific directory structure with components such as commands, agents, skills, and hooks organized at the root level.
Where should the plugin manifest be located?
The plugin manifest, named plugin.json, must be located within the .claude-plugin/ directory.
Can I use absolute paths in my component configuration?
No, all paths specified in the configuration must be relative to the plugin root and cannot use absolute paths.
What naming convention should I use for files and directories?
All directory and file names should use kebab-case format, meaning they should be lowercase and separated by hyphens.
Are there any limitations to the number of components I can create?
You should only create directories for components that your plugin actually uses; there are no limitations on the number of components as long as they are utilized.
Install Plugin Structure
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
anthropics/claude-code