skills.rest
nerinanarine
nerinanarineCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

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
One-click install
npx skills add https://github.com/nerinanarine/claudecode-devcontainer --skill plugin-structure-nerinanarine
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
sauvalasauvala

plugin-structure

Explain Claude Code plugin directory structure and manifest configuration.

Community
Advanced
zach-sourcezach-source

Plugin Structure

Guide Claude Code plugin architecture, directory structure, and manifest configuration.

Community
Intermediate
Kabilan108Kabilan108
2

Hook Development

Develop Claude Code plugin hooks with structured JSON and scripts to enforce safety and automate workflows.

Community
Advanced
jimloopjimloop

create-plugin

Create Claude Code plugins with valid component structures and configuration patterns.

Community
Intermediate