skills.rest
phpmac
phpmacCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/phpmac/skills --skill plugin-structure-phpmac
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
steltzsteltz

sft-scaffold-plugin

Generate plugin directory structures with plugin.json and SKILL.md templates.

Community
Intermediate
Clay-HHKClay-HHK
2

Plugin Structure

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

Community
Advanced
fcakyonfcakyon
1.0k

plugin-structure

Scaffold Claude Code plugins with manifest configuration and directory layout.

Community
Basic
AvaTar-ArTsAvaTar-ArTs

plugin-structure

Validate Claude Code plugin structures for required SKILL.md frontmatter and manifest paths.

Community
Intermediate