Where should the plugin.json manifest be located?

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

How does Claude Code find my commands and agents?

Claude Code uses an auto-discovery mechanism that scans the commands/, agents/, and skills/ directories at your plugin root automatically.

Why should I use ${CLAUDE_PLUGIN_ROOT} in my plugin?

Using this variable ensures your plugin is portable across different operating systems and installation paths by avoiding hardcoded absolute paths that vary by user.

Can I use custom directory names for my plugin components?

Yes, you can specify custom paths in the plugin.json manifest, which will supplement the default auto-discovery directories.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

개발자 도구

Standardizes the creation and organization of Claude Code plugins using best practices for manifests, discovery, and directory layouts.

소개

This skill provides comprehensive guidance on architecting Claude Code plugins, ensuring consistent directory structures and seamless integration within the Claude environment. It helps developers configure the required plugin.json manifest, manage automatic discovery of commands, agents, and skills, and implement portable pathing using the ${CLAUDE_PLUGIN_ROOT} environment variable. By following these standardized patterns, users can build maintainable, portable, and feature-rich extensions that leverage Claude Code's full potential for automation and custom workflows.

주요 기능

89 GitHub stars
Standardized directory layout conventions
Manifest (plugin.json) configuration guidance
Automatic component discovery patterns
Portable pathing with ${CLAUDE_PLUGIN_ROOT}
Structured organization for commands, agents, and hooks

사용 사례

Scaffolding a new Claude Code plugin from scratch
Troubleshooting component loading and path resolution issues
Refactoring existing scripts into the standard plugin format

소개

주요 기능

89 GitHub stars
Standardized directory layout conventions
Manifest (plugin.json) configuration guidance
Automatic component discovery patterns
Portable pathing with ${CLAUDE_PLUGIN_ROOT}
Structured organization for commands, agents, and hooks

사용 사례

Scaffolding a new Claude Code plugin from scratch
Troubleshooting component loading and path resolution issues
Refactoring existing scripts into the standard plugin format