Where should I place my subagent definitions?

Subagent definitions should be placed in the agents/ directory as markdown files located at the root level of your plugin.

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

It ensures your plugin remains portable across different operating systems and installation methods by resolving paths relative to the plugin's actual location.

How does Claude Code find my custom plugin commands?

Claude Code automatically scans the commands/ directory at the plugin root for markdown files containing valid YAML frontmatter.

Can I use custom paths for plugin components instead of the defaults?

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

What is the purpose of the .claude-plugin/ directory?

It contains the essential plugin.json manifest file that defines the plugin's metadata, versioning, and configuration.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

110

开发者工具

Provides standardized patterns and architectural guidance for building, scaffolding, and organizing Claude Code plugins.

关于

The Plugin Structure skill serves as a comprehensive architectural blueprint for developers building Claude Code extensions. It streamlines the plugin development lifecycle by providing immediate guidance on directory layouts, manifest configuration within the .claude-plugin directory, and the integration of specialized components like commands, agents, and MCP servers. By enforcing best practices such as the use of ${CLAUDE_PLUGIN_ROOT} for portable path resolution and standardized naming conventions, it ensures that custom plugins are maintainable, portable, and seamlessly discovered by the Claude Code environment.

主要功能

Manifest (plugin.json) configuration guidance
Portable path resolution using ${CLAUDE_PLUGIN_ROOT}
110 GitHub stars
Standardized directory layout scaffolding
Automated component discovery patterns
Best practices for commands, agents, and skills organization

使用场景

Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Converting hardcoded plugin paths into portable environment variables for cross-platform support
Organizing complex plugin components into a maintainable, auto-discoverable structure

关于

主要功能

Manifest (plugin.json) configuration guidance
Portable path resolution using ${CLAUDE_PLUGIN_ROOT}
110 GitHub stars
Standardized directory layout scaffolding
Automated component discovery patterns
Best practices for commands, agents, and skills organization

使用场景

Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Converting hardcoded plugin paths into portable environment variables for cross-platform support
Organizing complex plugin components into a maintainable, auto-discoverable structure