What is the required location for the plugin manifest?

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

Why should I use ${CLAUDE_PLUGIN_ROOT} instead of relative paths?

Using the ${CLAUDE_PLUGIN_ROOT} variable ensures your plugin remains portable across different operating systems and installation methods where the absolute path might vary.

Can I use custom directory names for my plugin components?

Yes, while default directories are auto-discovered, you can specify custom paths within the 'commands', 'agents', or 'skills' fields in your plugin.json manifest to supplement the defaults.

What naming convention is recommended for plugin files?

It is best practice to use kebab-case (lowercase with hyphens) for all directory and file names to ensure consistency and avoid cross-platform naming conflicts.

How does Claude Code discover new commands or agents?

Claude Code uses an auto-discovery mechanism that scans specific directories, such as /commands or /agents, for markdown files containing YAML frontmatter.

Plugin Architecture Guide

Name: Plugin Architecture Guide
Author: anthropics

byanthropics

•

291

개발자 도구

Standardizes Claude Code plugin development with guidance on directory layouts, manifest configuration, and automated component discovery.

소개

The Plugin Structure skill provides essential architectural patterns and implementation details for building robust Claude Code plugins. It simplifies the development process by guiding users through the creation of the required .claude-plugin directory, the configuration of plugin.json manifests, and the organization of modular components like commands, agents, and hooks. By enforcing best practices such as portable path references using the ${CLAUDE_PLUGIN_ROOT} variable and leveraging the auto-discovery mechanism, this skill ensures that plugins are maintainable, portable across different operating systems, and seamlessly integrated into the Claude Code ecosystem.

주요 기능

Standards for file naming and modular component organization
Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}
Automated directory scaffolding for commands, agents, and skills
Optimization of component auto-discovery for seamless loading
291 GitHub stars
Manifest configuration guidance for plugin.json metadata

사용 사례

Migrating hardcoded paths to portable environment variables for cross-platform support
Organizing complex plugins with multiple subagents, slash commands, and MCP servers
Scaffolding a new Claude Code plugin from scratch with the correct directory tree

소개

주요 기능

Standards for file naming and modular component organization
Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}
Automated directory scaffolding for commands, agents, and skills
Optimization of component auto-discovery for seamless loading
291 GitHub stars
Manifest configuration guidance for plugin.json metadata

사용 사례

Migrating hardcoded paths to portable environment variables for cross-platform support
Organizing complex plugins with multiple subagents, slash commands, and MCP servers
Scaffolding a new Claude Code plugin from scratch with the correct directory tree