skills.rest
Hex-4
Hex-4COMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Explain Claude Code plugin architecture, directory layout, and manifest configuration.

Updated May 29, 2026
Search Tags:#best practices#plugin architecture#directory layout#component organization#manifest configuration
One-click install
npx skills add https://github.com/Hex-4/dots --skill plugin-structure-hex-4
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/Hex-4/dots/tree/main/dot_claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/Hex-4/dots --skill plugin-structure-hex-4

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 you to create well-organized, maintainable plugins that integrate seamlessly with Claude Code.

Core Features & Use Cases

  • Plugin Directory Structure: Understand the conventional layout for automatic component discovery.
  • Manifest Configuration: Learn about the plugin.json manifest and its fields.
  • Component Organization: Explore the organization of commands, agents, skills, and hooks.
  • Path References: Utilize ${CLAUDE_PLUGIN_ROOT} for intra-plugin path references.
  • File Naming Conventions: Follow best practices for naming directories and files.
  • Auto-Discovery Mechanism: Discover and load components automatically.
  • Best Practices: Follow organization, naming, portability, and maintenance best practices.
  • Use Case: Use this Skill to create a plugin that integrates with Claude Code, organizing components like commands, agents, and hooks.

Quick Start

Use the plugin-structure skill to learn about plugin directory structure and manifest configuration.

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 directory for automatic component discovery?▼

You structure a Claude Code plugin directory by following a conventional layout that enables automatic component discovery, placing commands, agents, skills, and hooks in organized subdirectories for seamless loading and maintainability.

What is the plugin.json manifest and how do I configure it?▼

The plugin.json manifest is the configuration file for Claude Code plugins, containing essential fields that define the plugin and its components, ensuring proper integration and organization within the Claude Code framework.

How do I reference files within a Claude Code plugin?▼

Reference files within a Claude Code plugin by utilizing the `${CLAUDE_PLUGIN_ROOT}` path variable, which ensures reliable intra-plugin path references and maintains portability across different development environments.

What are the best practices for naming files and directories in a Claude Code plugin?▼

Best practices for naming files and directories in a Claude Code plugin involve following conventional naming rules that ensure maintainability, support auto-discovery mechanisms, and keep components well-organized.

Do I need prior experience with the Claude Code plugin framework to use this architecture guide?▼

Yes, you need prior knowledge of the Claude Code plugin framework and development environment to effectively apply this architecture guidance, as it covers advanced manifest configuration and component organization.

Related Skills

Explore More Software Engineering Skills→
EigenwiseEigenwise
15

init-workspace

Set up a Claude Code workspace with plugins, rules, and verification.

Community
Advanced
anthropicsanthropics
33.3k

Plugin Structure

Clarify Claude Code plugin architecture and component organization.

Official
Basic
float-ritual-stackfloat-ritual-stack

spec-components

Catalog UI spec components for structured design documentation blocks.

Official
Intermediate
phillip-hirschphillip-hirsch

plugin-structure

Explain Claude Code plugin architecture, directory layout, and component organization.

Community
Advanced