What naming convention should I use for plugin files?

All directory and file names should follow the kebab-case convention (lowercase letters separated by hyphens) for consistency and compatibility.

How do I make plugin paths portable across different systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for intra-plugin path references in your manifest, scripts, and component files.

Does Claude Code automatically find my plugin commands?

Yes, Claude Code features an auto-discovery mechanism that automatically loads markdown files located in the commands/, agents/, and skills/ directories.

Where must the plugin manifest be located?

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

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: michelabboud

bymichelabboud

•

Developer Tools

Guides the creation and organization of Claude Code plugins using standardized directory layouts and manifest configurations.

This skill provides a comprehensive architectural blueprint for building Claude Code plugins, ensuring seamless integration and maintainability. It covers essential patterns for the .claude-plugin/plugin.json manifest, directory hierarchies for commands, agents, and hooks, and the implementation of portable path references using the ${CLAUDE_PLUGIN_ROOT} variable. By following these established best practices for auto-discovery and naming conventions, developers can create robust, portable extensions that enhance Claude's capabilities across different environments.

Key Features

01Standardized directory layout for automatic component discovery

02Portable path management using ${CLAUDE_PLUGIN_ROOT}

03Best practices for naming conventions and file structures

04Comprehensive manifest (plugin.json) configuration patterns

051 GitHub stars

06Guidance on organizing commands, agents, and skills

Use Cases

01Configuring complex event hooks and MCP server integrations

02Scaffolding a new plugin with correct directory hierarchies

03Refactoring existing scripts into a formal Claude Code plugin

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add michelabboud/claude-code plugin-structure

For use in Claude.ai and ChatGPT

Download Skill