skills.rest
mahmoud20138
mahmoud20138COMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Organize Claude Code plugin components into a standardized directory layout.

10|2|Updated Mar 8, 2026
Search Tags:#architecture#plugin#manifest#commands#claude-code#auto-discovery#plugin-structure
One-click install
npx skills add https://github.com/mahmoud20138/Tradecraft --skill plugin-structure-mahmoud20138
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/mahmoud20138/Tradecraft/tree/main/plugins/tradecraft/skills/plugin-structure
Command: npx skills add https://github.com/mahmoud20138/Tradecraft --skill plugin-structure-mahmoud20138

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guidance helps developers implement a canonical Claude Code plugin layout by clarifying where manifests live, how to organize commands, agents, skills, hooks, and MCP configurations, and how to enable automatic component discovery.

Core Features & Use Cases

  • Standard directory layout including .claude-plugin/plugin.json, commands/, agents/, skills/, hooks/, .mcp.json
  • Auto-discovery of components to enable plug-and-play collaboration and consistent onboarding
  • Portable path references using ${CLAUDE_PLUGIN_ROOT} to ensure cross-environment compatibility
  • Clear guidance on naming conventions, manifest configuration, and component organization for maintenance and scalability
  • Useful for plugin authors, engineers, and maintainers building Claude Code integrations

Quick Start

Create a new plugin folder with a .claude-plugin/plugin.json manifest and a skills/ subfolder containing SKILL.md, then follow the guide to organize commands, agents, and hooks.

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?▼

Use the ${CLAUDE_PLUGIN_ROOT} variable to define portable path references in your Claude Code plugin. This ensures cross-environment compatibility so manifests and components resolve correctly regardless of the deployment environment.

What is the standard directory layout for Claude Code plugins?▼

Claude Code plugins can include commands, agents, skills, hooks, and MCP configurations. These components are organized into dedicated subdirectories to enable auto-discovery, plug-and-play collaboration, and consistent onboarding for development teams.

How do I create a manifest for a Claude Code plugin?▼

SKILL.md uses YAML frontmatter to document skills within Claude Code plugins. This standardizes the skill definitions and supports optional resources, ensuring maintainers can organize and discover skills consistently across the plugin directory.

Does Claude Code plugin structure support optional resources?▼

Yes, the Claude Code plugin structure supports optional resources through the skills subdirectory containing SKILL.md. This allows plugin authors to include supplementary components while maintaining a standardized layout for maintenance and scalability.

Related Skills

Explore More Software Engineering Skills→
ecielamecielam

Plugin Structure

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

Community
Intermediate
timgranlundmarsdentimgranlundmarsden
2

Plugin Structure

Organize Claude Code plugin directories and validate plugin.json manifests.

Community
Advanced
TorchedHatTorchedHat
6

plugin-writer

Create and configure Claude Code plugins with valid metadata and directory structures.

Official
Intermediate
Tashima-TarshTashima-Tarsh
1

Plugin Structure

Structure Claude Code plugins with valid plugin.json manifests and auto-discovery.

Community
Intermediate