plugin-structure

Scaffold CLAUDE Code plugins with directory layouts and frontmatter conventions.

15|4|Updated Apr 18, 2026

Search Tags:#architecture #discovery #plugin #organization #manifest #best-practices #claude-code

Ready to run

npx skills add https://github.com/damionrashford/media-os --skill plugin-structure-damionrashford

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/damionrashford/media-os/tree/main/.claude/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/damionrashford/media-os --skill plugin-structure-damionrashford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE Code plugin developers need a clear, repeatable blueprint for organizing components, manifests, and auto-discovery; this skill codifies best practices to reduce setup friction and errors.

Core Features & Use Cases

Directory conventions for commands, agents, skills, and hooks
How to configure plugin.json and custom paths for MCP servers
Real-world patterns and templates for production-grade plugin layouts

Quick Start

Create a minimal plugin scaffold with a proper plugin.json and a sample SKILL.md to bootstrap your workflow.

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 commands, agents, and hooks?▼

Claude Code plugin structure uses specific directory conventions to organize commands, agents, skills, and hooks. A standardized layout ensures reliable auto-discovery and reduces setup friction when loading plugin components.

What is a plugin.json manifest and how does it configure MCP servers?▼

A plugin.json manifest defines plugin metadata and configures custom paths for MCP servers. It serves as the central reference point that enables Claude Code to correctly load and auto-discover associated skills and hooks.

Do I need SKILL.md frontmatter for Claude Code plugin auto-discovery?▼

Yes, SKILL.md frontmatter is required for Claude Code plugin auto-discovery. Proper frontmatter conventions ensure that the plugin loader correctly identifies and registers skills within the directory structure.

What's the best way to scaffold a production-grade Claude Code plugin?▼

The best way to scaffold a Claude Code plugin is to start with a minimal directory layout, add a proper plugin.json, and create a sample SKILL.md. This blueprint codifies best practices for varied project sizes.

Why does my Claude Code plugin fail to load components correctly?▼

Plugin loading fails when the directory layout or SKILL.md frontmatter does not follow auto-discovery rules. Inconsistent structure or missing manifest references in plugin.json disrupt reliable component registration.