plugin-structure

Originally fromanthropics/claude-code
Installation
Summary

Standardized directory structure and manifest configuration for Claude Code plugins with automatic component discovery.

  • Conventional layout with auto-discovery: commands, agents, skills, and hooks load automatically from standard directories without explicit registration
  • Manifest-driven configuration in .claude-plugin/plugin.json supporting metadata, custom component paths, and optional MCP server definitions
  • Portable path references using ${CLAUDE_PLUGIN_ROOT} environment variable for all intra-plugin file references across different installation contexts
  • Component organization patterns: commands and agents as markdown files with YAML frontmatter, skills as subdirectories containing SKILL.md, hooks as JSON event handler configuration
SKILL.md

Plugin Structure for Claude Code

Overview

Claude Code plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Claude Code.

Key concepts:

  • Conventional directory layout for automatic discovery
  • Manifest-driven configuration in .claude-plugin/plugin.json
  • Component-based organization (commands, agents, skills, hooks)
  • Portable path references using ${CLAUDE_PLUGIN_ROOT}
  • Explicit vs. auto-discovered component loading

Directory Structure

Every Claude Code plugin follows this organizational pattern:

plugin-name/
Related skills

More from anthropics/claude-plugins-official

Installs
2.3K
GitHub Stars
19.2K
First Seen
Feb 5, 2026