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

•

開発者ツール

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

概要

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.

主な機能

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

ユースケース

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

概要

主な機能

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

ユースケース

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