How does auto-discovery work in Claude Code plugins?

Claude Code automatically scans specific root-level directories like /commands, /agents, and /skills for valid Markdown and JSON files, registering them without requiring manual paths in the manifest.

Where should the Claude Code plugin manifest be located?

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

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is an environment variable used for portable path references. It ensures that your plugin scripts and assets work correctly regardless of the user's operating system or installation path.

Can I use custom directory names for my plugin components?

Yes, while there are default locations, you can specify custom paths for commands, agents, hooks, and MCP servers within the plugin.json manifest file.

Plugin Structure for Claude Code

Name: Plugin Structure for Claude Code
Author: Delqhi

byDelqhi

•

개발자 도구

Standardizes the architecture and organization of Claude Code plugins using conventional directory layouts and manifest configurations.

This skill provides specialized guidance for developers building Claude Code plugins, ensuring they adhere to the required directory structures and naming conventions for seamless integration. It covers the creation of the plugin manifest, the organization of commands, subagents, and skills, and the implementation of portable path references using the ${CLAUDE_PLUGIN_ROOT} variable. By following these architectural patterns, developers can create maintainable, auto-discoverable extensions that enhance Claude's capabilities through hooks, MCP servers, and specialized domain knowledge.

주요 기능

01Portable path management using ${CLAUDE_PLUGIN_ROOT} variables

02Standardized .claude-plugin/plugin.json manifest configuration

03Template patterns for hooks and MCP server integration

04Automated component discovery for commands, agents, and skills

05Kebab-case naming conventions for consistent plugin architecture

061 GitHub stars

사용 사례

01Migrating existing scripts and tools into a formal plugin structure

02Configuring event hooks and MCP servers for automated workflows

03Scaffolding a new Claude Code plugin with the correct directory layout

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add delqhi/zoe-solar-accounting-ocr plugin-structure

For use in Claude.ai and ChatGPT

Download Skill