How does auto-discovery work in Claude Code?

Claude automatically scans specific root-level directories like /commands, /agents, and /skills for compatible markdown files and configurations upon plugin enablement.

What naming convention should I use for plugin files?

It is best practice to use kebab-case (lowercase with hyphens) for all directory and file names to ensure consistency and prevent cross-platform file system issues.

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

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

Where should the plugin.json manifest be located?

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

Can I use custom paths for my commands or agents?

Yes, you can specify custom paths in the plugin.json manifest; these will supplement the default auto-discovery directories rather than replacing them.

Claude Plugin Structure Architect

Name: Claude Plugin Structure Architect
Author: pur3v4d3r

bypur3v4d3r

•

Herramientas para Desarrolladores

Standardizes the creation and organization of Claude Code plugins using best-practice directory layouts and manifest configurations.

Acerca de

This skill provides comprehensive guidance on building portable and maintainable Claude Code plugins. It assists developers in scaffolding directory structures, configuring the plugin.json manifest, and implementing auto-discovery for commands, agents, skills, and hooks. By enforcing naming conventions and utilizing the ${CLAUDE_PLUGIN_ROOT} variable, it ensures that plugins are architected for seamless integration and cross-platform compatibility within the Claude Code ecosystem.

Características Principales

Implementation of component auto-discovery mechanisms
1 GitHub stars
Automated directory scaffolding for commands, agents, and skills
Guidance on event-driven hooks and MCP server integration
Manifest configuration guidance for plugin.json metadata
Portable path management using ${CLAUDE_PLUGIN_ROOT}

Casos de Uso

Bootstrapping a new Claude Code plugin from scratch with the correct layout
Refactoring existing scripts into a modular, auto-discoverable plugin format
Debugging component loading and manifest path resolution issues

Acerca de

Características Principales

Implementation of component auto-discovery mechanisms
1 GitHub stars
Automated directory scaffolding for commands, agents, and skills
Guidance on event-driven hooks and MCP server integration
Manifest configuration guidance for plugin.json metadata
Portable path management using ${CLAUDE_PLUGIN_ROOT}

Casos de Uso

Bootstrapping a new Claude Code plugin from scratch with the correct layout
Refactoring existing scripts into a modular, auto-discoverable plugin format
Debugging component loading and manifest path resolution issues