skills.rest
saadmsft
saadmsftCOMMUNITY
Explore all skills by this author →
Website𝕏@saadmehGitHub

claude-plugin-dev-plugin-structure

Guide Claude Code plugin architecture, directory structure, and file naming conventions.

Updated May 21, 2026
Search Tags:#claude code#plugin development#plugin design#plugin architecture#plugin structure
One-click install
npx skills add https://github.com/saadmsft/ghcp-plugins-unofficial --skill claude-plugin-dev-plugin-structure
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-plugin-dev-plugin-structure
Source: https://github.com/saadmsft/ghcp-plugins-unofficial/tree/main/plugins/plugin-dev/skills/claude-plugin-dev-plugin-structure
Command: npx skills add https://github.com/saadmsft/ghcp-plugins-unofficial --skill claude-plugin-dev-plugin-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill empowers you to understand and design Claude Code plugins with a comprehensive guide on architecture, directory structure, and best practices.

Core Features & Use Cases

  • Plugin Architecture Overview: Learn about the conventional directory structure and manifest configuration.
  • Component Organization: Explore how to organize commands, agents, skills, hooks, and scripts.
  • File Naming Conventions: Understand best practices for naming files and directories.
  • Auto-Discovery Mechanism: Discover how Claude Code automatically finds and loads components.
  • Best Practices: Get guidelines for organization, naming, portability, and maintenance.
  • Common Patterns: Learn from minimal to advanced plugin examples.
  • Troubleshooting: Find solutions to common issues like component loading and path resolution.

Quick Start

Use the 'claude-plugin-dev-plugin-structure' skill to learn about the directory structure for Claude Code plugins.

Frequently Asked Questions about claude-plugin-dev-plugin-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the recommended directory structure for a Claude Code plugin?▼

The recommended Claude Code plugin directory structure organizes components like commands, agents, skills, hooks, and scripts into a conventional layout driven by the plugin.json manifest for auto-discovery.

How does Claude Code automatically discover and load plugin components?▼

Claude Code auto-discovery mechanism automatically finds and loads plugin components by scanning the conventional directory structure and reading the plugin.json manifest configuration.

How do I organize files and components when developing a Claude Code plugin?▼

Organize Claude Code plugin components by following file naming conventions and separating commands, agents, skills, hooks, and scripts into dedicated directories for maintainability.

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

Best practices for Claude Code plugin file naming involve using conventional directory structures and consistent naming patterns to ensure proper component organization and auto-discovery.

Why is my Claude Code plugin component not loading or resolving paths correctly?▼

Plugin component loading and path resolution issues typically stem from incorrect directory structure, manifest configuration errors, or violating file naming conventions required by Claude Code's auto-discovery mechanism.

Do I need a plugin.json manifest to build a Claude Code plugin?▼

Yes, the plugin.json manifest is required for Claude Code plugin development as it provides the configuration necessary for the auto-discovery mechanism to find and load components.

Related Skills

Explore More Software Engineering Skills→
ecielamecielam

Plugin Structure

Scaffold Claude Code plugins with standardized directory structures and manifest configuration.

Community
Intermediate
timequitytimequity
6

intermediate

Create custom skills, commands, servers, and hooks for automating workflows in Claude Code.

Official
Intermediate
goodnessibehgoodnessibeh
1

plugin-structure

Explain Claude Code plugin directory structure and plugin.json configuration.

Community
Advanced
SterlingChinSterlingChin
1.0k

skill-creator

Scaffold new MARVIN skills with SKILL.md frontmatter and directory structures.

Community
Basic