Where should the plugin.json file be located?

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

Can I use custom directory names for my plugin components?

Yes, while standard directories are scanned by default, you can specify custom paths for commands, agents, and hooks in your plugin.json manifest.

What is ${CLAUDE_PLUGIN_ROOT} used for?

It is an environment variable used for portable path references, ensuring your plugin works correctly regardless of the operating system or installation path.

How does Claude Code find my commands and agents?

Claude Code uses an auto-discovery mechanism that automatically scans the commands/ and agents/ directories for Markdown files with valid YAML frontmatter.

Claude Plugin Structure & Scaffolding

Name: Claude Plugin Structure & Scaffolding
Author: zach-source

byzach-source

0•

Herramientas para Desarrolladores

Guides developers through the standardized directory layout, manifest configuration, and component organization for building Claude Code plugins.

This skill provides comprehensive architectural guidance for developers building Claude Code plugins, ensuring they follow the required directory structure and naming conventions for seamless integration. It covers everything from configuring the plugin.json manifest and metadata to organizing slash commands, specialized subagents, and auto-activating skills. By mastering standardized path references like ${CLAUDE_PLUGIN_ROOT} and understanding the auto-discovery mechanism, developers can create portable, maintainable, and high-performance extensions for the Claude Code ecosystem.

Características Principales

01Comprehensive plugin.json manifest configuration and metadata rules

02Implementation of portable paths using ${CLAUDE_PLUGIN_ROOT}

03Guidance on organizing commands, subagents, and auto-activating skills

04Best practices for file naming conventions and plugin portability

05Standardized directory layout for automatic component discovery

060 GitHub stars

Casos de Uso

01Refactoring existing scripts into a portable, redistributable plugin format

02Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy

03Debugging component loading issues by verifying manifest paths and discovery rules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zach-source/claude-plugins plugin-structure

For use in Claude.ai and ChatGPT

Download Skill