Can I define custom paths for my plugin components?

Yes, you can supplement default discovery by specifying custom relative paths in the manifest, such as 'commands': ['./custom-folder'], which adds those locations to the search path.

What is the difference between a command and a skill in a plugin?

Commands are user-triggered via slash prefixes (e.g., /review), while skills are background capabilities that Claude Code autonomously activates based on the task context.

How does Claude Code discover new commands and agents?

Claude Code uses an auto-discovery mechanism that automatically scans the commands/, agents/, and skills/ directories for markdown files with valid YAML frontmatter.

Why is ${CLAUDE_PLUGIN_ROOT} important for plugin development?

It is an environment variable that provides the absolute path to the plugin root, ensuring your scripts and hooks work correctly regardless of the user's operating system or installation path.

What is the required location for the plugin manifest?

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

Plugin Structure & Architecture

Name: Plugin Structure & Architecture
Author: chrismcgraw60

bychrismcgraw60

開発者ツール

Standardizes the scaffolding and organization of Claude Code plugins using conventional directory layouts and manifest configurations.

概要

This skill serves as a comprehensive guide and automation assistant for developers building Claude Code extensions. It ensures plugins are built with the correct directory hierarchy—including commands, agents, skills, and hooks—while maintaining compliance with the required manifest specifications. By following these architectural patterns, developers can create portable, maintainable plugins that leverage Claude Code's auto-discovery mechanisms and the ${CLAUDE_PLUGIN_ROOT} environment variable for seamless cross-platform integration.

主な機能

Configures event-driven hooks and Model Context Protocol (MCP) server definitions
Generates and validates .claude-plugin/plugin.json manifest files
Implements portable path referencing using the ${CLAUDE_PLUGIN_ROOT} convention
Scaffolds standard plugin directory structures for automatic component discovery
Organizes slash commands, subagents, and skills with proper YAML frontmatter
0 GitHub stars

ユースケース

Initial scaffolding of a new Claude Code plugin with all required metadata
Configuring complex event hooks for automated pre-tool and post-tool execution
Restructuring existing scripts into a modular component-based plugin architecture

概要

主な機能

Configures event-driven hooks and Model Context Protocol (MCP) server definitions
Generates and validates .claude-plugin/plugin.json manifest files
Implements portable path referencing using the ${CLAUDE_PLUGIN_ROOT} convention
Scaffolds standard plugin directory structures for automatic component discovery
Organizes slash commands, subagents, and skills with proper YAML frontmatter
0 GitHub stars

ユースケース

Initial scaffolding of a new Claude Code plugin with all required metadata
Configuring complex event hooks for automated pre-tool and post-tool execution
Restructuring existing scripts into a modular component-based plugin architecture