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

0•

개발자 도구

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.

주요 기능

01Manifest-driven configuration for plugin.json

02Best practices for naming conventions and versioning

03Standardized directory layout for automatic discovery

040 GitHub stars

05Portable path resolution using ${CLAUDE_PLUGIN_ROOT}

06Component-based organization for commands and agents

사용 사례

01Organizing complex scripts into a maintainable plugin format

02Scaffolding a new Claude Code plugin from scratch

03Configuring hooks and MCP servers for portable deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/claude-code-plugins plugin-structure

For use in Claude.ai and ChatGPT

Download Skill