How do I ensure my plugin works on different operating systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal file references rather than hardcoding absolute paths or relative shortcuts.

Where should the Claude Code plugin manifest be located?

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

What is the difference between Commands and Agents in a plugin?

Commands are user-invoked slash commands defined in Markdown, while Agents are specialized sub-entities that Claude Code can invoke automatically based on the task context.

Does Claude Code automatically detect my plugin components?

Yes, Claude Code uses an auto-discovery mechanism that scans specific directories like /commands, /agents, and /skills for compatible Markdown files.

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: lusya123

bylusya123

Herramientas para Desarrolladores

Standardizes the architecture and directory layout for Claude Code plugins to ensure portability and automatic component discovery.

Acerca de

This skill provides comprehensive guidance on organizing Claude Code plugins, from manifest configuration in .claude-plugin/plugin.json to implementing commands, agents, and hooks. It ensures developers follow best practices for component-based organization and portable path references using ${CLAUDE_PLUGIN_ROOT}, enabling seamless integration and distribution across different operating systems and installation methods. By following these patterns, developers can leverage Claude Code's auto-discovery mechanism to build maintainable and scalable AI extensions.

Características Principales

Standardized directory layout mapping for commands, agents, skills, and hooks
0 GitHub stars
Automated component discovery configuration and manifest management
Best practices for modular plugin design and cross-platform compatibility
Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} environment variable
Naming convention enforcement for kebab-case files and directories

Casos de Uso

Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Refactoring an existing plugin to support portability and auto-discovery
Troubleshooting component loading issues in complex plugin architectures

Acerca de

Características Principales

Standardized directory layout mapping for commands, agents, skills, and hooks
0 GitHub stars
Automated component discovery configuration and manifest management
Best practices for modular plugin design and cross-platform compatibility
Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} environment variable
Naming convention enforcement for kebab-case files and directories

Casos de Uso

Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Refactoring an existing plugin to support portability and auto-discovery
Troubleshooting component loading issues in complex plugin architectures