plugin-structure

Explain Claude Code plugin directory structure and plugin.json configuration.

1|3|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/goodnessibeh/ai-dev-boilerplate --skill plugin-structure-goodnessibeh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/goodnessibeh/ai-dev-boilerplate/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/goodnessibeh/ai-dev-boilerplate --skill plugin-structure-goodnessibeh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and examples (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance on Claude Code plugin architecture, including directory structure, component organization, and best practices, enabling developers to create well-organized, maintainable plugins.

Core Features & Use Cases

  • Directory Structure: Detailed guide on the conventional directory layout for Claude Code plugins.
  • Component Organization: Overview of plugin.json manifest configuration, component organization patterns, and auto-discovery mechanisms.
  • File Naming Conventions: Best practices for naming files and directories within plugins.
  • Auto-Discovery Mechanism: How Claude Code automatically discovers and loads components from plugins.
  • Best Practices: Guidance on organization, naming, portability, and maintenance for plugins.
  • Use Case: Imagine you're starting a new Claude Code plugin. Use this Skill to understand the structure, set up your plugin.json, and organize your components for maintainability and efficiency.

Quick Start

Run the SKILL.md file to learn about Claude Code plugin architecture and best practices.

Frequently Asked Questions about plugin-structure

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

FAQPage Schema
What is the standard directory structure for a Claude Code plugin?

The standard directory structure for a Claude Code plugin organizes components into specific folders with a root plugin.json manifest. This layout enables automatic discovery and efficient loading of your plugin's scripts and references during runtime.

How does component auto-discovery work in Claude Code plugins?

Component auto-discovery in Claude Code plugins works by automatically detecting and loading components based on standard directory layouts and file naming conventions. This mechanism eliminates manual configuration and streamlines the integration of new scripts and references.

How do I configure the plugin.json manifest for component organization?

Configuring the plugin.json manifest involves defining metadata and structural rules to organize your plugin components effectively. This manifest acts as the central configuration file, ensuring proper lifecycle management and seamless auto-discovery of included elements.

What are the best practices for file naming conventions in plugin development?

File naming conventions in plugin development require consistent, predictable patterns for directories and files to maintain portability and ease of maintenance. Following these best practices ensures that the auto-discovery mechanism correctly identifies and loads your components.

Do I need prior plugin development experience to use this architecture guide?

You do not need extensive prior experience to use this architecture guide, as it provides comprehensive knowledge on directory structure and component organization. It is designed to help developers at various levels create well-organized and maintainable plugins.