plugin-structure

Scaffold CLAUDE Code plugins with directory layouts and frontmatter conventions.

15|4|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/damionrashford/media-os --skill plugin-structure-damionrashford
Or copy as Structured Prompt for Agent
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.