Plugin Structure

Scaffold Claude Code plugin structures with manifest configuration and auto-discovery.

3|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/Delqhi-Projects/ZOE-Solar-Accounting-OCR --skill plugin-structure-delqhi-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Plugin Structure
Source: https://github.com/Delqhi-Projects/ZOE-Solar-Accounting-OCR/tree/main/.claude/PLUGINS/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/Delqhi-Projects/ZOE-Solar-Accounting-OCR --skill plugin-structure-delqhi-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a clear blueprint for building Claude Code plugins by detailing standard directory layouts, where to place the manifest, and how components are auto-discovered.

Core Features & Use Cases

  • Understand plugin directory structure (commands, agents, skills, hooks) and the role of SKILL.md files.
  • Learn how to configure plugin manifests (.claude-plugin/plugin.json) and how auto-discovery loads components.
  • Reference best practices for naming, path resolution, and modular organization to enable scalable plugins.
  • Use cases include scaffolding new plugins, auditing existing plugin setups, and guiding teams through consistent plugin architectures.

Quick Start

Create a new Claude Code plugin skeleton following the Plugin Structure guidelines.

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?

Structure a Claude Code plugin by organizing commands, agents, skills, and hooks into standard directory layouts with a manifest at .claude-plugin/plugin.json to enable automatic component discovery and loading.

What is a SKILL.md file and how does it work in plugin organization?

A SKILL.md file provides frontmatter-backed skill definitions within a plugin directory, enabling reliable auto-discovery and execution of modular skills by specifying required metadata and path configurations.

How do I configure a plugin manifest for commands and hooks?

Configure the plugin manifest at .claude-plugin/plugin.json by specifying relative paths for commands, agents, skills, and hooks to ensure reliable auto-discovery and loading across standard plugin components.

Does Claude Code auto-discovery require specific directory layouts?

Yes, Claude Code auto-discovery requires standard directory layouts with correct manifest placement, relative paths, and frontmatter-backed skill definitions to reliably load commands, agents, skills, and hooks.

What is the best way to scaffold a scalable Claude Code plugin?

The best way to scaffold a scalable Claude Code plugin is to follow standard directory layouts for components, configure the manifest correctly, and apply modular naming and path resolution best practices.