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

•

Herramientas para Desarrolladores

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

Acerca de

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.

Características Principales

Standardized directory layout for automatic component discovery
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Best practices for naming conventions and file structures
Comprehensive manifest (plugin.json) configuration patterns
1 GitHub stars
Guidance on organizing commands, agents, and skills

Casos de Uso

Configuring complex event hooks and MCP server integrations
Scaffolding a new plugin with correct directory hierarchies
Refactoring existing scripts into a formal Claude Code plugin

Acerca de

Características Principales

Standardized directory layout for automatic component discovery
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Best practices for naming conventions and file structures
Comprehensive manifest (plugin.json) configuration patterns
1 GitHub stars
Guidance on organizing commands, agents, and skills

Casos de Uso

Configuring complex event hooks and MCP server integrations
Scaffolding a new plugin with correct directory hierarchies
Refactoring existing scripts into a formal Claude Code plugin