What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is a dynamic environment variable used to reference the plugin's root directory, ensuring that paths remain portable across different user environments and operating systems.

Where should the plugin manifest be located?

The plugin.json manifest must be located within a directory named .claude-plugin/ at the root of your plugin folder.

Can I use custom directory names for my commands and agents?

Yes, while Claude Code defaults to 'commands/' and 'agents/', you can define custom paths within the 'plugin.json' manifest using relative path syntax.

Does Claude Code require a restart after plugin changes?

No, Claude Code uses an auto-discovery mechanism that registers changes and new components for the next active session without requiring a full restart.

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: astrosteveo

byastrosteveo

Herramientas para Desarrolladores

Architects standardized Claude Code plugins using optimized directory layouts and manifest-driven configurations.

Acerca de

This skill provides comprehensive guidance for building Claude Code plugins using a standardized architecture to ensure seamless integration and automatic component discovery. It details the essential directory organization, manifest (plugin.json) specifications, and implementation patterns for commands, agents, skills, and hooks, while emphasizing the use of portable path references via ${CLAUDE_PLUGIN_ROOT} for cross-platform reliability.

Características Principales

Manifest-driven configuration for plugin.json
Best practices for naming conventions and versioning
Standardized directory layout for automatic discovery
0 GitHub stars
Portable path resolution using ${CLAUDE_PLUGIN_ROOT}
Component-based organization for commands and agents

Casos de Uso

Organizing complex scripts into a maintainable plugin format
Scaffolding a new Claude Code plugin from scratch
Configuring hooks and MCP servers for portable deployment