skills.rest
vepat-a11y
vepat-a11yCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Explain Claude Code plugin structure and plugin.json configuration.

Updated May 13, 2026
Search Tags:#Claude Code#developer guide#plugin architecture#plugin.json#component organization
One-click install
npx skills add https://github.com/vepat-a11y/Odoo-Quote-Calc --skill plugin-structure-vepat-a11y
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/vepat-a11y/Odoo-Quote-Calc/tree/main/.claude-user/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/vepat-a11y/Odoo-Quote-Calc --skill plugin-structure-vepat-a11y

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, yaml, and 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, helping developers understand and create well-organized, maintainable plugins.

Core Features & Use Cases

  • Plugin Directory Structure: Learn the standardized directory layout for Claude Code plugins and how components are organized.
  • Manifest Configuration: Understand how to configure the plugin.json manifest file for plugin metadata and settings.
  • Component Organization: Explore patterns for organizing commands, agents, skills, hooks, and MCP servers.
  • Use Cases: Ideal for users looking to create, organize, or understand Claude Code plugins, or for those who need to configure plugin.json or use ${CLAUDE_PLUGIN_ROOT}.

Quick Start

Learn about Claude Code plugin architecture by running the command '/plugin-structure'.

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 and organize its components?▼

Claude Code plugins require a standardized directory layout organizing commands, agents, skills, hooks, and MCP servers. This structure ensures components are maintainable and correctly configured for Claude Code to load and execute them.

What is the best way to configure plugin.json for a Claude Code plugin?▼

The plugin.json manifest file configures plugin metadata and settings for Claude Code. Defining this file correctly establishes the plugin's identity, dependencies, and operational parameters within the Claude Code environment.

How does the portable path reference work in Claude Code plugin architecture?▼

Portable path references use the `${CLAUDE_PLUGIN_ROOT}` variable to dynamically locate assets and scripts. This mechanism ensures your plugin remains functional regardless of where the plugin directory is installed on the local system.

Do I need to know Markdown and YAML to create a Claude Code plugin?▼

Yes, knowledge of Markdown and YAML is required to create SKILL.md files for Claude Code plugins. These formats are used to define the plugin's documentation, instructions, and configuration metadata.

What are the limitations when organizing multiple MCP servers in a Claude Code plugin?▼

Claude Code plugin architecture organizes MCP servers alongside commands and hooks within a standardized directory. Proper configuration in plugin.json is essential to prevent conflicts when managing multiple server components.

Related Skills

Explore More Software Engineering Skills→
louloulinlouloulin
19

skill-md-validator

Validate SKILL.md files for YAML frontmatter, required fields, and content.

Community
Basic
reggiechan74reggiechan74
5

plugins

Create, deploy, and govern Claude Code plugins with manifest and marketplace metadata.

Community
Intermediate
kurohit2kurohit2
1

Plugin Structure

Guide Claude Code plugin structure with manifest configuration and directory layouts.

Community
Advanced
kaustubhhiwarekaustubhhiware

plugin-structure

Guide Claude Code plugin architecture, manifest configuration, and component organization.

Community
Intermediate