What is the required location for the plugin manifest?

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

Why should I use ${CLAUDE_PLUGIN_ROOT}?

This environment variable ensures your plugin remains portable across different operating systems and installation methods by avoiding hardcoded absolute paths.

How does Claude Code discover new commands?

Claude Code automatically scans the commands/ directory for Markdown files with YAML frontmatter and registers them as native slash commands.

Can I use custom paths for plugin components?

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

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

110

Developer Tools

Standardizes the creation and organization of Claude Code plugins through formal directory structures and manifest configurations.

About

This skill provides comprehensive guidance on building Claude Code plugins, ensuring they follow standardized conventions for automatic component discovery. It assists developers in scaffolding plugin layouts, configuring the plugin.json manifest, and organizing commands, agents, and hooks correctly. By using this skill, developers can create portable, maintainable extensions that integrate seamlessly with the Claude Code environment using best practices like ${CLAUDE_PLUGIN_ROOT} and manifest-driven configuration.

Key Features

Standardized directory layout scaffolding
Automatic component discovery for commands and agents
110 GitHub stars
Manifest (plugin.json) configuration guidance
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Event hook and MCP server integration patterns

Use Cases

Troubleshooting component discovery and path resolution issues
Refactoring existing scripts into a standardized plugin structure
Scaffolding a new Claude Code plugin from scratch

About

Key Features

Standardized directory layout scaffolding
Automatic component discovery for commands and agents
110 GitHub stars
Manifest (plugin.json) configuration guidance
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Event hook and MCP server integration patterns

Use Cases

Troubleshooting component discovery and path resolution issues
Refactoring existing scripts into a standardized plugin structure
Scaffolding a new Claude Code plugin from scratch