What is the purpose of the ${CLAUDE_PLUGIN_ROOT} variable?

It is an environment variable that provides a portable way to reference files within your plugin, ensuring scripts and assets work regardless of the user's operating system or installation path.

How does auto-discovery work in Claude Code plugins?

Claude Code automatically scans standard directories like /commands, /agents, and /skills for markdown files, registering them as functional components without requiring manual manifest entries.

Where must the plugin manifest be located?

The plugin.json manifest file must always be placed within the .claude-plugin/ directory at the root of your plugin folder.

Can I use custom directories for my plugin components?

Yes, you can specify custom relative paths in your plugin.json manifest using fields like 'commands' or 'agents', which will supplement the default auto-discovery locations.

Claude Code Plugin Structure Architect

Name: Claude Code Plugin Structure Architect
Author: brixtonpham

bybrixtonpham

0•

Developer Tools

Scaffolds and organizes standardized Claude Code plugin directory layouts and manifest configurations for seamless component discovery.

This skill provides comprehensive guidance and automated scaffolding for building Claude Code plugins, ensuring developers follow the required directory conventions and manifest specifications. It helps organize commands, subagents, and skills while implementing portable pathing with the ${CLAUDE_PLUGIN_ROOT} variable and configuring auto-discovery mechanisms. Whether you are creating a simple slash command or a complex system with MCP servers and event hooks, this skill ensures your extensions are maintainable, portable, and fully integrated into the Claude Code ecosystem.

Key Features

01Manifest (plugin.json) metadata and field configuration guidance

02Automated plugin directory scaffolding and layout organization

030 GitHub stars

04Standardized component organization for commands, agents, and skills

05Portable path management using the ${CLAUDE_PLUGIN_ROOT} variable

06Configuration support for auto-discovery, hooks, and MCP servers

Use Cases

01Scaffolding a new Claude Code plugin with correct folder hierarchy

02Implementing portable event hooks and MCP server definitions

03Refactoring loose scripts into a formal, distributable plugin structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add brixtonpham/dot-claude plugin-structure

For use in Claude.ai and ChatGPT

Download Skill