Can I define multiple agents in a single plugin?

Yes, you can define multiple specialized agents by placing their respective markdown definition files in the agents/ directory.

Where should the plugin manifest be located?

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

How do I ensure my plugin is portable across different systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for internal path references instead of hardcoded absolute paths.

Does Claude Code automatically load my plugin commands?

Yes, Claude Code uses an auto-discovery mechanism that automatically loads all .md files located in the commands/ directory at the plugin root.

Claude Code Plugin Structure Guide

Name: Claude Code Plugin Structure Guide
Author: Activer007

byActiver007

개발자 도구

Guides the creation and organization of Claude Code plugins using standardized directory layouts and manifest configurations.

소개

This skill provides comprehensive architectural guidance for developers building extensions for Claude Code. It outlines the essential requirements for plugin development, including the correct placement of the plugin.json manifest, the hierarchical organization of commands, agents, and hooks, and the implementation of portable path references using the ${CLAUDE_PLUGIN_ROOT} variable. By following these standardized patterns, developers can ensure their plugins are maintainable, portable, and compatible with Claude Code's automated component discovery mechanism.

주요 기능

Automated component discovery protocols
Portable path resolution via environment variables
Component-based organization patterns
Standardized directory layout scaffolding
Manifest-driven configuration guidance
0 GitHub stars

사용 사례

Scaffolding a new Claude Code plugin with correct folder structures
Configuring event hooks and MCP servers for custom workflows
Organizing scripts and subagents into a distributable plugin format

소개

주요 기능

Automated component discovery protocols
Portable path resolution via environment variables
Component-based organization patterns
Standardized directory layout scaffolding
Manifest-driven configuration guidance
0 GitHub stars

사용 사례

Scaffolding a new Claude Code plugin with correct folder structures
Configuring event hooks and MCP servers for custom workflows
Organizing scripts and subagents into a distributable plugin format