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 project.

Can I define custom paths for my plugin components?

Yes, you can supplement the default directories by specifying custom relative paths for commands, agents, or hooks within your plugin.json manifest.

How does Claude Code discover my plugin components?

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

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is an environment variable used to reference the plugin's root directory, ensuring that paths remain portable across different user environments and operating systems.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

114

開発者ツール

Guides developers through the standardized directory structure and manifest configuration for building Claude Code plugins.

概要

This skill provides comprehensive guidance on the Claude Code plugin architecture, covering everything from initial scaffolding to advanced configuration. It ensures developers follow best practices for component organization—including commands, agents, skills, and hooks—while leveraging the manifest-driven discovery system. By utilizing the ${CLAUDE_PLUGIN_ROOT} environment variable and standardized naming conventions, this skill helps users build portable, maintainable, and production-ready extensions that integrate perfectly with the Claude Code ecosystem.

主な機能

Standardized directory layout and scaffolding guidance
Detailed manifest (plugin.json) configuration support
Automated component discovery and registration rules
Portable path resolution using ${CLAUDE_PLUGIN_ROOT}
Best practices for commands, agents, skills, and hooks
114 GitHub stars

ユースケース

Troubleshooting component loading and auto-discovery issues
Scaffolding a new Claude Code plugin with correct directory hierarchy
Refactoring hardcoded paths to ensure cross-platform portability

概要

主な機能

Standardized directory layout and scaffolding guidance
Detailed manifest (plugin.json) configuration support
Automated component discovery and registration rules
Portable path resolution using ${CLAUDE_PLUGIN_ROOT}
Best practices for commands, agents, skills, and hooks
114 GitHub stars

ユースケース

Troubleshooting component loading and auto-discovery issues
Scaffolding a new Claude Code plugin with correct directory hierarchy
Refactoring hardcoded paths to ensure cross-platform portability