What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is a dynamic environment variable used to reference the plugin's root directory, ensuring that file paths remain portable across different operating systems and installation methods.

Where should the plugin.json file be located?

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

How does Claude Code discover new commands?

Claude Code automatically scans the commands/ directory for any .md files with valid YAML frontmatter and loads them as native slash commands.

Can I use custom paths for my plugin components?

Yes, you can specify custom relative paths for commands, agents, and hooks within the plugin.json manifest to supplement the default directory structure.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

開発者ツール

Provides comprehensive guidance on scaffolding, organizing, and configuring Claude Code plugins using standardized directory structures and manifests.

概要

This skill empowers developers to build well-structured and maintainable Claude Code plugins by providing clear patterns for directory layout, manifest (plugin.json) configuration, and component discovery. It covers essential architectural concepts like the ${CLAUDE_PLUGIN_ROOT} variable, auto-discovery mechanisms for commands and skills, and best practices for organizing agents, hooks, and MCP servers. Whether you are scaffolding a new project or optimizing an existing one, this skill ensures your tools integrate seamlessly with the Claude Code ecosystem.

主な機能

Portable path management using ${CLAUDE_PLUGIN_ROOT} variables
Automatic component discovery patterns for seamless integration
Standardized directory scaffolding for commands, agents, and skills
1 GitHub stars
Manifest configuration guidance for plugin.json and .mcp.json
Best practices for naming conventions and component modularity

ユースケース

Migrating local scripts and utilities into a formal, portable plugin structure
Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Optimizing plugin discovery and configuring event-driven hooks or MCP servers

概要

主な機能

Portable path management using ${CLAUDE_PLUGIN_ROOT} variables
Automatic component discovery patterns for seamless integration
Standardized directory scaffolding for commands, agents, and skills
1 GitHub stars
Manifest configuration guidance for plugin.json and .mcp.json
Best practices for naming conventions and component modularity

ユースケース

Migrating local scripts and utilities into a formal, portable plugin structure
Scaffolding a new Claude Code plugin from scratch with the correct hierarchy
Optimizing plugin discovery and configuring event-driven hooks or MCP servers