skills.rest
markshd12-cloud
markshd12-cloudCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Explain Claude Code plugin directory layout and manifest configuration.

Updated Jul 8, 2026
Search Tags:#claude code#plugin development#plugin architecture#component organization#manifest configuration
One-click install
npx skills add https://github.com/markshd12-cloud/Jarvis --skill plugin-structure-markshd12-cloud
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/markshd12-cloud/Jarvis/tree/main/agents/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/markshd12-cloud/Jarvis --skill plugin-structure-markshd12-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

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

Core Features & Use Cases

  • Plugin Directory Structure: Learn the conventional directory layout for automatic component discovery.
  • Manifest Configuration: Understand the plugin.json manifest and its fields.
  • Component Organization: Explore patterns for organizing commands, agents, skills, hooks, and MCP servers.
  • Portable Path References: Utilize ${CLAUDE_PLUGIN_ROOT} for path references across the plugin.
  • File Naming Conventions: Follow naming conventions for consistency and clarity.
  • Auto-Discovery Mechanism: Explore how Claude Code automatically discovers and loads components.
  • Best Practices: Implement best practices for organization, naming, portability, and maintenance.
  • Common Patterns: Study minimal, full-featured, and skill-focused plugin patterns.
  • Troubleshooting: Get help for common issues like component loading and path resolution.

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 directory structure for a Claude Code plugin?▼

The directory structure for a Claude Code plugin uses a conventional layout that enables automatic component discovery, organizing commands, agents, skills, and hooks into specific folders for maintainability.

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

You configure the plugin manifest by defining fields within the `plugin.json` file, which dictates how Claude Code loads and interacts with your plugin components and overall architecture.

How do I use portable path references in Claude Code plugin development?▼

Portable path references in Claude Code plugin development utilize the `${CLAUDE_PLUGIN_ROOT}` variable, ensuring your file paths remain stable and functional across different deployment environments.

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

Auto-discovery for Claude Code plugin components works by automatically scanning the conventional directory layout and loading commands, agents, skills, and hooks without requiring manual registration.

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

Best practices for Claude Code plugin file naming conventions dictate following consistent patterns for clarity, ensuring the auto-discovery mechanism correctly identifies and loads your components without conflicts.

Why are my Claude Code plugin components not loading correctly?▼

Claude Code plugin components may fail to load correctly due to incorrect directory structure, invalid `plugin.json` manifest configuration, or improper path resolution outside of `${CLAUDE_PLUGIN_ROOT}`.

Related Skills

Explore More Software Engineering Skills→
hckhanhhckhanh
3

ctx-upgrade

Fetch, build, install, and configure the Context Mode plugin automatically.

Community
Intermediate
Kingdaddy007Kingdaddy007
1

command-development

Design and validate Claude Code slash commands with structured frontmatter.

Community
Advanced
ayubunayubun
8

creating-a-plugin

Guide developers in creating opencode plugins with structured directories and plugin.json manifests.

Community
Intermediate
Delqhi-ProjectsDelqhi-Projects
3

Plugin Structure

Scaffold Claude Code plugin structures with manifest configuration and auto-discovery.

Official
Advanced