Where should the plugin manifest be located?

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

Can I use custom directories for my plugin components?

Yes, while Claude has default folders, you can specify custom relative paths for commands, agents, and hooks in your plugin.json file.

How does Claude Code discover new commands?

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

What is the difference between a Command and a Skill?

Commands are user-invoked slash commands, whereas Skills are domain-specific guidance that Claude activates autonomously based on the task context.

Why is ${CLAUDE_PLUGIN_ROOT} important?

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

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

開発者ツール

Standardizes and accelerates the creation of Claude Code plugins through structured directory layouts and manifest configuration.

概要

This skill provides comprehensive guidance for developers building and maintaining Claude Code extensions. It streamlines the process of scaffolding plugin directories, configuring the required plugin.json manifest, and organizing complex components like slash commands, subagents, and hooks. By enforcing architectural best practices—such as using portable path references via ${CLAUDE_PLUGIN_ROOT} and adhering to auto-discovery conventions—it ensures that custom AI tools are robust, portable, and seamlessly integrated into the Claude Code ecosystem.

主な機能

Standardized directory scaffolding for commands, agents, and skills
Portable path management using ${CLAUDE_PLUGIN_ROOT} variables
Best practices for component naming and auto-discovery mechanisms
0 GitHub stars
Automated manifest (plugin.json) configuration and metadata setup
Event hook registration and MCP server integration guidance

ユースケース

Refactoring loose scripts into a formal, discoverable plugin architecture
Scaffolding a new Claude Code plugin from scratch with a valid directory structure
Configuring complex event-driven hooks and MCP server connections for advanced workflows

概要

主な機能

Standardized directory scaffolding for commands, agents, and skills
Portable path management using ${CLAUDE_PLUGIN_ROOT} variables
Best practices for component naming and auto-discovery mechanisms
0 GitHub stars
Automated manifest (plugin.json) configuration and metadata setup
Event hook registration and MCP server integration guidance

ユースケース

Refactoring loose scripts into a formal, discoverable plugin architecture
Scaffolding a new Claude Code plugin from scratch with a valid directory structure
Configuring complex event-driven hooks and MCP server connections for advanced workflows