skills.rest
astoeffer
astoefferCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Guide Claude Code plugin organization, manifest formats, and SKILL.md conventions.

Updated Aug 27, 2026
Search Tags:#discovery#plugin#structure#SKILL.md#plugin.json
One-click install
npx skills add https://github.com/astoeffer/plugin-marketplace --skill plugin-structure-astoeffer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/astoeffer/plugin-marketplace/tree/main/plugins/plugin-builder/skills/plugin-structure
Command: npx skills add https://github.com/astoeffer/plugin-marketplace --skill plugin-structure-astoeffer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guides plugin authors on proper Claude Code plugin structure, manifest formats, and component placement to ensure market-readiness.

Core Features & Use Cases

  • Directory Rules: Plugins must place commands, agents, and skills at the root level.
  • SKILL.md Format: Enforces proper frontmatter and skill layout.
  • Validation & Troubleshooting: Helps diagnose plugin loading and discovery issues.

Quick Start

Structure your plugin with proper root-level directories and SKILL.md-based skills, then run validations to ensure discovery.

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 with proper directory layout?▼

Claude Code plugins require root-level directories for commands, agents, and skills. Place skills under skills/skill-name/SKILL.md format with proper frontmatter. Validate your plugin.json manifest to ensure all mandatory fields are present and correctly formatted for discovery.

What are the requirements for plugin.json and SKILL.md files?▼

plugin.json must validate against Claude Code plugin schema with required fields for metadata and configuration. SKILL.md enforces frontmatter conventions and skill layout rules. Both files are mandatory for plugins, commands, agents, hooks, and MCP server settings to load correctly.

Why isn't my Claude Code plugin being discovered?▼

Plugin discovery fails when directory structure violates root-level placement rules, plugin.json validation fails, or SKILL.md frontmatter is malformed. Run validation checks to diagnose exact issues, then restructure components and re-validate manifest formats to restore discoverability.

Can I place commands, agents, and skills in subdirectories within my plugin?▼

No. Claude Code plugin rules require commands, agents, and skills to be placed at the root level, not nested in subdirectories. Skills must follow the skills/skill-name/SKILL.md format specifically. Violating root-level placement prevents proper plugin loading and market readiness.

What happens if my plugin.json is missing required fields?▼

Missing required fields in plugin.json cause validation failures and prevent plugin loading. The Skill provides comprehensive guidance on mandatory versus optional fields for plugins, commands, agents, hooks, and MCP server settings to ensure full compliance.

How do I troubleshoot plugin loading and discovery issues?▼

Validation and troubleshooting starts by checking directory rules, plugin.json schema compliance, and SKILL.md format adherence. The Skill helps diagnose exact structural violations, manifest format errors, and field placement issues to resolve loading failures systematically.

Related Skills

Explore More Software Engineering Skills→
Clay-HHKClay-HHK
2

Plugin Structure

Create and organize Claude Code plugin structures with plugin.json manifests.

Community
Advanced
ronnycodingronnycoding
20

create-claude-plugin

Create Claude Code plugins bundling skills, agents, commands, hooks, and MCP servers.

Community
Intermediate
AnthonyKazyakaAnthonyKazyaka
2

plugin-creator

Automate Claude Code plugin creation and validation with structured directory checks.

Community
Advanced
wayne930242wayne930242
16

write-plugin

Create complete Claude Code plugin packages with manifests, commands, agents, skills, and hooks.

Community
Advanced