plugin-structure

Validate SKILL.md frontmatter and directory layout for plugin Skill units.

Updated Aug 23, 2026

Search Tags:#skills #agents #plugin #structure #manifest #commands #claude-code

Ready to run

npx skills add https://github.com/phpmac/skills --skill plugin-structure-phpmac

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarifies the rules and best practices for organizing Claude Code plugins, ensuring each Skill is discoverable via SKILL.md frontmatter and located within the correct directory layout.

Core Features & Use Cases

Provides standard directory templates and naming conventions for commands, agents, skills, and hooks.
Illustrates how SKILL.md frontmatter defines a Skill's identity and how Claude Code auto-discovers Skill units.
Helps maintain consistency across plugins and simplifies onboarding for new plugin authors.

Quick Start

Review the plugin-structure SKILL.md to identify the mandatory SKILL.md frontmatter (name and description) and the recommended directory layout (skills/plugin-structure/ with SKILL.md).

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

To structure a Claude Code plugin, organize skills under a standard directory layout and include a SKILL.md file with mandatory frontmatter at the plugin root to enable reliable auto-discovery.

What is the required frontmatter for a SKILL.md file?▼

The required frontmatter for a SKILL.md file includes name and description fields, which define the Skill's identity and ensure Claude Code can validate and activate the plugin correctly.

How do I name directories and commands in a Claude Code plugin?▼

Directory and command naming should use kebab-case conventions to maintain consistency across plugins and simplify onboarding for new plugin authors.

Can I include optional resources like scripts and assets in my plugin?▼

Yes, plugins organized under the standard directory layout support optional resources like scripts, references, and assets alongside the mandatory SKILL.md file.

Why is my Claude Code plugin not activating properly?▼

Plugin activation fails if the SKILL.md file lacks mandatory frontmatter, uses incorrect naming conventions, or is not located within the correct directory layout.

Does plugin-structure enforce specific directory layouts for hooks and agents?▼

Yes, the plugin-structure provides standard directory templates and naming conventions for commands, agents, skills, and hooks to ensure consistent plugin organization.