Claude Plugin Structure Architect FAQs

Question 1

How does auto-discovery work in Claude Code?

Accepted Answer

Claude automatically scans specific root-level directories like /commands, /agents, and /skills for compatible markdown files and configurations upon plugin enablement.

Question 2

What naming convention should I use for plugin files?

Accepted Answer

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

Question 3

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

Accepted Answer

It is a dynamic environment variable used for portable path references, ensuring your plugin scripts and resources work across different operating systems and installation paths.

Question 4

Where should the plugin.json manifest be located?

Accepted Answer

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

Question 5

Can I use custom paths for my commands or agents?

Accepted Answer

Yes, you can specify custom paths in the plugin.json manifest; these will supplement the default auto-discovery directories rather than replacing them.

Claude Plugin Structure Architect

Key Features

Use Cases

Claude Plugin Structure Architect

Key Features

Use Cases