What is the required location for the plugin manifest?

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

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

You should always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal path references to ensure portability across macOS, Linux, and Windows.

Does Claude Code automatically find my commands?

Yes, Claude Code uses an auto-discovery mechanism that automatically scans the commands/, agents/, and skills/ directories for compatible markdown files.

Can I use custom directory names for my plugin components?

Yes, while default directories are scanned automatically, you can specify custom paths in the plugin.json manifest using relative paths starting with ./

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

Herramientas para Desarrolladores

Guides developers in scaffolding, organizing, and configuring Claude Code plugins using standardized directory structures and manifest patterns.

Acerca de

This skill provides comprehensive architectural guidance for building Claude Code plugins, ensuring seamless integration through proper directory layouts and manifest configurations. It helps users navigate the complexities of component-based organization—including commands, agents, skills, and hooks—while enforcing best practices like portable path references via ${CLAUDE_PLUGIN_ROOT}. By following this standardized approach, developers can create maintainable, auto-discoverable extensions that enhance Claude's capabilities across different operating systems and installation environments.

Características Principales

Manifest (plugin.json) configuration guidance
Portable path referencing with ${CLAUDE_PLUGIN_ROOT}
81 GitHub stars
Standardized directory layout scaffolding
Component organization for commands and agents
Automatic component discovery patterns

Casos de Uso

Migrating custom scripts into a structured plugin format
Scaffolding a new Claude Code plugin from scratch
Optimizing plugin manifests for automatic component discovery