Plugin Structure

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

10|5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Claude-Code-Community-Ireland/claude-code-resources --skill plugin-structure-claude-code-community-ireland
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Plugin Structure
Source: https://github.com/Claude-Code-Community-Ireland/claude-code-resources/tree/main/plugins/vibeworks-library/skills/plugin-structure
Command: npx skills add https://github.com/Claude-Code-Community-Ireland/claude-code-resources --skill plugin-structure-claude-code-community-ireland

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides comprehensive guidance on building robust and well-organized Claude Code plugins, ensuring seamless integration and maintainability.

Core Features & Use Cases

  • Plugin Architecture: Understand directory layouts, manifest configuration, and component organization.
  • Auto-Discovery: Learn how Claude Code automatically finds and loads your plugin's commands, agents, skills, and hooks.
  • Use Case: You need to create a new plugin for your team's workflow. This Skill will guide you through setting up the correct directory structure, configuring the plugin.json manifest, and organizing your commands, agents, and skills for optimal discoverability and maintainability.

Quick Start

Follow the plugin structure guidelines to scaffold a new Claude Code plugin.

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 for auto-discovery?

To structure a Claude Code plugin for auto-discovery, organize commands, agents, skills, hooks, and MCP servers into specific directories, then configure the plugin.json manifest to enable automatic loading and seamless integration.

What is the correct directory layout for Claude Code plugin development?

The correct directory layout for Claude Code plugin development separates commands, agents, skills, hooks, and MCP servers into dedicated folders, governed by a plugin.json manifest file to ensure component organization and maintainability.

How does manifest configuration work in Claude Code plugins?

Manifest configuration in Claude Code plugins uses the plugin.json file to define component organization, enabling auto-discovery mechanisms to automatically locate and load commands, agents, skills, and hooks without manual registration.

Can I use portable path references when building Claude Code plugins?

Yes, you can use portable path references when building Claude Code plugins to ensure directory structures remain valid across different environments, allowing commands and agents to reliably locate required components.

What components are required to scaffold a new Claude Code plugin?

Scaffolding a new Claude Code plugin requires configuring a plugin.json manifest and organizing directories for commands, agents, skills, hooks, and MCP servers to ensure optimal discoverability and maintainability for team workflows.

Why are my Claude Code plugin commands not loading automatically?

Claude Code plugin commands fail to load automatically when the directory structure or plugin.json manifest configuration does not match the expected auto-discovery layout, preventing the system from finding and registering components correctly.