What is ${CLAUDE_PLUGIN_ROOT} used for?

It is a dynamic environment variable used for portable path references, ensuring your plugin's scripts and assets work across different operating systems and installation locations.

Where should the plugin.json manifest be located?

The plugin.json file must be placed within the .claude-plugin/ directory at the root of your plugin to be correctly recognized by Claude Code.

Can I use custom paths for my plugin components?

Yes, you can define custom paths in your plugin.json manifest. These paths supplement the default directories rather than replacing them.

How does Claude Code find my commands and agents?

Claude Code uses an auto-discovery mechanism that automatically scans the 'commands/', 'agents/', and 'skills/' directories for Markdown files and component definitions.

What are the naming conventions for components?

All directory and file names should use kebab-case (lowercase with hyphens) to ensure cross-platform compatibility and maintain a clean project structure.

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: stevessr

bystevessr

0•

개발자 도구

Standardizes the creation and organization of Claude Code plugins using best practices for directory layouts, manifests, and component discovery.

This skill provides a comprehensive framework for developing Claude Code plugins, ensuring seamless integration and high maintainability. It guides developers through the mandatory directory hierarchy, including the .claude-plugin/ manifest and specialized folders for commands, agents, skills, and hooks. By implementing portable path references via ${CLAUDE_PLUGIN_ROOT} and adhering to naming conventions, developers can build robust, portable extensions that Claude can automatically discover and utilize to enhance its core capabilities.

주요 기능

01Automated directory structure scaffolding

02Manifest (plugin.json) configuration guidance

03Component organization for commands, agents, and skills

04Auto-discovery mechanism optimization

05Portable path management using ${CLAUDE_PLUGIN_ROOT}

060 GitHub stars

사용 사례

01Scaffolding a new Claude Code plugin from scratch with the correct file hierarchy

02Refactoring existing scripts into a standardized Claude Code plugin format

03Configuring complex event hooks and MCP servers within the plugin manifest

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add stevessr/dotsfiles plugin-structure

For use in Claude.ai and ChatGPT

Download Skill