skills.rest
Animesh-Kr
Animesh-KrCOMMUNITY
Explore all skills by this author →
Website𝕏@AnimeshKumar_GitHub

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
One-click install
npx skills add https://github.com/Animesh-Kr/claude-skills --skill plugin-structure-animesh-kr
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
fritzprixfritzprix
8

system-setup

Install and verify MCP runtime dependencies across Windows, Linux, and macOS.

Community
Intermediate
zxpmailzxpmail
18

release-builder

Automate build, test, and publish lifecycle for web, desktop, and CLI applications.

Community
Advanced
SkillsCatalogSkillsCatalog
1

skill-validator

Validate agent skill directories against the SKILL.md specification.

Official
Advanced
kgadekkgadek

Plugin Structure

Standardize Claude Code plugin structures with manifest placement and auto-discovery.

Community
Advanced