Claude Code Plugin Architecture & Scaffolding FAQs

Question 1

Where should commands be placed in a Claude Code plugin?

Accepted Answer

Commands should be stored as Markdown files within a 'commands/' directory at the plugin root level to enable automatic discovery by Claude Code.

Question 2

What is the purpose of the .claude-plugin/plugin.json file?

Accepted Answer

It serves as the central manifest for your plugin, defining essential metadata like the plugin name, version, and optional custom paths for components.

Question 3

Why is using ${CLAUDE_PLUGIN_ROOT} important for plugin development?

Accepted Answer

It ensures portability by providing a dynamic reference to the plugin's installation directory, preventing broken paths across different operating systems or user setups.

Question 4

Can I use custom directory names for my plugin components?

Accepted Answer

Yes, while standard names are recommended, you can specify custom relative paths for commands, agents, or hooks within the plugin.json manifest file.

Question 5

How does Claude Code handle component auto-discovery?

Accepted Answer

Claude Code automatically scans the commands/, agents/, and skills/ directories for appropriately formatted files (like SKILL.md) and registers them without requiring manual manifest entries.

Claude Code Plugin Architecture & Scaffolding

주요 기능

사용 사례

Claude Code Plugin Architecture & Scaffolding

주요 기능

사용 사례