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

개발자 도구

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

소개

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.

주요 기능

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

사용 사례

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

소개

주요 기능

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

사용 사례

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