plugin-structure

Automate Claude Code plugin scaffolding with standardized directory layouts and entry points.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/rodgemd1-lgtm/Startup-Intelligence-OS --skill plugin-structure-rodgemd1-lgtm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/rodgemd1-lgtm/Startup-Intelligence-OS/tree/main/archive/resource-hub/claude-plugins/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/rodgemd1-lgtm/Startup-Intelligence-OS --skill plugin-structure-rodgemd1-lgtm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plugin structure guidance and scaffolding for Claude Code, ensuring a consistent layout, manifest placement, and clear component boundaries.

Core Features & Use Cases

  • Standard directory layouts (commands, agents, skills, hooks, MCP)
  • Clear SKILL.md entry points and frontmatter templates
  • Guidance on auto-discovery, path references, and naming conventions
  • Practical templates and references for fast plugin scaffolding

Quick Start

Create a new plugin directory with a .claude-plugin/plugin.json and a skills/<skill-name>/SKILL.md to begin scaffolding.

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?

A Claude Code plugin needs a root .claude-plugin/plugin.json manifest alongside organized directories for commands, agents, skills, hooks, and MCP configurations. This standardized layout enables proper auto-discovery and clear component boundaries.

What is the correct SKILL.md frontmatter format for Claude Code?

The correct SKILL.md frontmatter format for Claude Code requires valid metadata fields defined in the plugin's entry point. Scaffolding tools provide standardized templates to ensure your SKILL.md frontmatter is properly configured for safe default practices.

How do I scaffold a new Claude Code plugin from scratch?

To scaffold a new Claude Code plugin from scratch, create a plugin directory containing a .claude-plugin/plugin.json file and a skills/<skill-name>/SKILL.md file. This establishes the foundational structure for adding commands, agents, and hooks.

What directories should a Claude Code plugin include?

A Claude Code plugin should include standard directories for commands, agents, skills, hooks, and MCP configurations. These recommended component directories ensure proper organization, path references, and naming conventions for auto-discovery.

Can I use custom naming conventions for Claude Code plugin components?

Claude Code plugin components should follow recommended naming conventions to ensure proper auto-discovery and path references. While the structure is standardized, the scaffolding provides guidance on safe default practices for organizing your specific components.

Why does my Claude Code plugin manifest fail auto-discovery?

Plugin manifest auto-discovery fails when the .claude-plugin/plugin.json is misplaced or SKILL.md frontmatter is invalid. Ensure your plugin follows the standardized directory layout with clear entry points and valid frontmatter to resolve path reference issues.