Why should I use ${CLAUDE_PLUGIN_ROOT} in my configuration?

Using ${CLAUDE_PLUGIN_ROOT} ensures your plugin is portable across different operating systems and installation methods by avoiding hardcoded absolute paths.

How does Claude Code discover new commands and agents?

Claude Code uses an auto-discovery mechanism that scans the commands/, agents/, and skills/ directories at the plugin root for markdown and configuration files.

What are hooks in a Claude Code plugin?

Hooks are event handlers defined in hooks.json or the manifest that execute automatically in response to events like tool use, session start, or user prompts.

What is the required location for the plugin manifest?

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

Can I include custom scripts within a Claude Code skill?

Yes, skills are organized in subdirectories within the skills/ folder and can include their own scripts, references, and assets alongside the required SKILL.md file.

Claude Code Plugin Architecture Guide

Name: Claude Code Plugin Architecture Guide
Author: Microck

byMicrock

•

学习与文档

Standardizes the creation and organization of Claude Code plugins through structured directory layouts and manifest configurations.

关于

This skill provides comprehensive guidance on the architecture and organization of Claude Code plugins, ensuring developers build extensions that are portable and maintainable. It details the mandatory directory structure, the specific configuration requirements for the plugin.json manifest, and the implementation of core components like slash commands, subagents, and auto-activating skills. By following these established patterns and using portable pathing like ${CLAUDE_PLUGIN_ROOT}, developers can leverage Claude Code's auto-discovery mechanisms for seamless tool integration.

主要功能

Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} variable
Comprehensive manifest configuration for plugin metadata and paths
Implementation patterns for commands, agents, skills, and hooks
81 GitHub stars
Standardized directory layout for automatic component discovery
Guidance on MCP server integration and naming conventions

使用场景

Scaffolding and bootstrapping a new Claude Code plugin project
Organizing complex plugins with multiple subagents and specialized skills
Refactoring legacy scripts into standardized Claude Code components

关于

主要功能

Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} variable
Comprehensive manifest configuration for plugin metadata and paths
Implementation patterns for commands, agents, skills, and hooks
81 GitHub stars
Standardized directory layout for automatic component discovery
Guidance on MCP server integration and naming conventions

使用场景

Scaffolding and bootstrapping a new Claude Code plugin project
Organizing complex plugins with multiple subagents and specialized skills
Refactoring legacy scripts into standardized Claude Code components