Browse / Developer Tools / Claude Plugin Structure

Claude Plugin Structure

Provides comprehensive guidance on the architecture, directory layout, and best practices for creating Claude Code plugins.

SkillDeveloper ToolsPatterns ArchitectureSkill Authoring

Key features

  • Provides best practices for file naming, organization, and maintenance.
  • Details component organization for commands, agents, skills, hooks, and MCP servers.
  • Explains the required and recommended fields for the `plugin.json` manifest.
  • Enforces the use of `${CLAUDE_PLUGIN_ROOT}` for portable path references.
  • Defines the standard directory layout with auto-discovery for all component types.

Use cases

  • Understanding the structure of an existing plugin.
  • Troubleshooting issues with component discovery or path resolution errors.
  • Scaffolding a new Claude Code plugin from scratch.

FAQ

What key capabilities does it provide guidance on?

It details the standard directory layout for all components, explains the required and recommended fields for the `plugin.json` manifest, and enforces the use of `${CLAUDE_PLUGIN_ROOT}` for creating portable path references in your plugin.

How does this skill improve my workflow?

It ensures your plugins are built correctly from the start, leveraging Claude Code's auto-discovery features. This reduces setup time, prevents common structural errors, and makes your plugins portable, shareable, and easier to maintain.

When should I use this skill?

Use this skill whenever you need to create a new plugin, scaffold a project, or understand how to properly organize components. It's essential for tasks like defining `plugin.json`, adding new commands or agents, and configuring auto-discovery.

What does the Claude Plugin Structure skill do?

This skill provides expert guidance on the standard architecture for Claude Code plugins. It explains the required directory layout, manifest file (`plugin.json`), component organization (commands, agents, skills), and best practices for creating maintainable plugins.