plugin-structure

Name: plugin-structure
Availability: InStock
Author: nerinanarine

Explain Claude Code plugin directory structure and component organization.

Updated Apr 13, 2026

Search Tags:#Claude Code #plugin development #plugin architecture #directory structure #component organization

Ready to run

npx skills add https://github.com/nerinanarine/claudecode-devcontainer --skill plugin-structure-nerinanarine

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/nerinanarine/claudecode-devcontainer/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/nerinanarine/claudecode-devcontainer --skill plugin-structure-nerinanarine

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides comprehensive guidance on Claude Code plugin architecture, directory layout, and best practices, enabling users to create well-organized, maintainable plugins that integrate seamlessly with Claude Code.

Core Features & Use Cases

Plugin Directory Structure: Learn the standard directory structure for Claude Code plugins and the organization of components like commands, agents, skills, and hooks.
Plugin Manifest Configuration: Understand the plugin.json manifest and its required and recommended fields for defining plugin metadata and configuration.
Component Organization: Explore how to organize components such as commands, agents, skills, and hooks within a plugin.
Auto-Discovery Mechanism: Discover how Claude Code automatically discovers and loads components from plugins.
Best Practices: Gain insights into best practices for plugin development, including organization, naming conventions, portability, and maintenance.

Quick Start

Use the plugin-structure skill to understand the directory structure of a Claude Code plugin.

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 Claude Code plugin directory structure organizes components like commands, agents, skills, and hooks into dedicated subdirectories, ensuring maintainability and enabling the framework's auto-discovery mechanism to load components seamlessly.

How do I configure the plugin manifest for Claude Code?▼

You configure the Claude Code plugin manifest using the `plugin.json` file, which defines required and recommended metadata fields to specify plugin configuration and ensure proper integration with the Claude Code framework.

How does auto-discovery work for Claude Code plugin components?▼

Auto-discovery in Claude Code works by automatically scanning the plugin's directory structure to find and load organized components such as commands, agents, skills, and hooks without requiring manual registration for each file.

Do I need prior plugin development experience to use Claude Code plugin architecture?▼

Yes, understanding the Claude Code plugin architecture requires prerequisite knowledge of the Claude Code framework and plugin development concepts to effectively implement directory layouts, portable path references, and component organization.

What are the best practices for Claude Code plugin file naming and portability?▼

Best practices for Claude Code plugin development include following standard file naming conventions, using portable path references, and maintaining a clean component organization to ensure plugins remain maintainable and seamlessly integrated.