Plugin Structure

Clarify Claude Code plugin structure and auto-discovery rules.

Updated Aug 27, 2026

Search Tags:#hooks #skills #agents #manifest #commands #claude-code #plugin-structure

Ready to run

npx skills add https://github.com/Animesh-Kr/claude-skills --skill plugin-structure-animesh-kr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Plugin Structure
Source: https://github.com/Animesh-Kr/claude-skills/tree/main/claude-code-main/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/Animesh-Kr/claude-skills --skill plugin-structure-animesh-kr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plugin developers often struggle with organizing Claude Code plugin structure. This guide clarifies the standard Claude Code plugin structure, manifest expectations, and auto-discovery rules to ensure consistency and reliability.

Core Features & Use Cases

Directory structure guidance for commands, agents, skills, and hooks
Manifest configuration in plugin.json and optional custom paths
Auto-discovery mechanisms and portable path references using ${CLAUDE_PLUGIN_ROOT}
Naming conventions and best practices for maintainability

Quick Start

Create a new plugin directory with the standard layout and a minimal SKILL.md to bootstrap discovery.

Frequently Asked Questions about Plugin Structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I structure a Claude Code plugin for auto-discovery?▼

To structure a Claude Code plugin for auto-discovery, organize commands, agents, skills, and hooks into standard directories and include a minimal SKILL.md to bootstrap the process.

What is the correct directory layout for Claude Code plugins?▼

The correct directory layout for Claude Code plugins separates commands, agents, skills, and hooks into dedicated folders, ensuring consistency and reliable resource references.

How do I configure plugin.json for a Claude Code extension?▼

Configuring plugin.json for a Claude Code extension involves defining the manifest expectations and optional custom paths to ensure the plugin scales properly.

Can I use custom paths for hooks and agents in Claude Code?▼

Yes, you can use custom paths for hooks and agents in Claude Code by specifying them in plugin.json, while using ${CLAUDE_PLUGIN_ROOT} for portable path references.

What are the naming conventions for Claude Code plugin components?▼

Naming conventions for Claude Code plugin components focus on maintainability and standard directory rules, ensuring frontmatter usage and resource references are consistently applied.

Why is my Claude Code plugin not auto-discovering commands?▼

Claude Code plugins fail to auto-discover commands when the directory structure lacks standard layout conventions or a minimal SKILL.md file needed to bootstrap discovery.