What is the required location for the plugin manifest?

The plugin.json file must be located within the .claude-plugin/ directory at the plugin root to be recognized by Claude Code.

How do I add multiple paths for agents in my plugin?

You can specify an array of relative paths in the 'agents' field of your plugin.json manifest to supplement the default directory discovery.

Does Claude Code automatically find my custom commands?

Yes, any Markdown files located in the commands/ directory are automatically discovered and registered as slash commands during the plugin loading process.

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 dynamically relative to where the plugin is installed.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

Developer Tools

Guides developers in scaffolding, organizing, and configuring professional-grade Claude Code plugins using standardized architectural patterns.

About

This skill provides comprehensive guidance on the Claude Code plugin ecosystem, helping developers build maintainable and portable extensions. It covers everything from manifest configuration in .claude-plugin/plugin.json to the implementation of commands, agents, skills, and hooks. By enforcing directory conventions and teaching the use of portable path references like ${CLAUDE_PLUGIN_ROOT}, it ensures that plugins integrate seamlessly and operate reliably across different user environments and operating systems.

Key Features

Standardized manifest configuration for .claude-plugin/plugin.json
Auto-discovery mechanism optimization for seamless integration
Implementation of portable paths via ${CLAUDE_PLUGIN_ROOT}
Component-based organization for commands, agents, and hooks
Automated plugin scaffolding and directory layout guidance
0 GitHub stars

Use Cases

Scaffolding a new Claude Code plugin from scratch
Organizing complex custom commands and sub-agents into a modular structure
Migrating hardcoded paths to portable environment-aware references

About

Key Features

Standardized manifest configuration for .claude-plugin/plugin.json
Auto-discovery mechanism optimization for seamless integration
Implementation of portable paths via ${CLAUDE_PLUGIN_ROOT}
Component-based organization for commands, agents, and hooks
Automated plugin scaffolding and directory layout guidance
0 GitHub stars

Use Cases

Scaffolding a new Claude Code plugin from scratch
Organizing complex custom commands and sub-agents into a modular structure
Migrating hardcoded paths to portable environment-aware references