What problem does it solve?
Provides a structured blueprint for creating, organizing, and refining Claude Code plugin skills, enabling teams to craft lean, reusable SKILL.md documents and establish progressive disclosure with references and assets for long-term maintainability.
Core Features & Use Cases
-
Enforces YAML frontmatter with clear, third-person description to reliably trigger skills.
-
Outlines progressive disclosure by moving detailed patterns and advanced material into references/ for efficient context loading.
-
Prescribes a lean SKILL.md body (1,500-2,000 words ideal) with actionable workflows and explicit trigger phrases.
-
Defines a standard plugin structure: skills/<skill-name>/{references,examples,scripts,assets} and validation steps.
-
Use Case: A plugin author creates a new skill to handle a domain-specific workflow, then incrementally expands with references and examples as needed.
-
Use Case: A team audits existing skills to improve trigger phrases and content organization for clearer activation.
-
Use Case: A maintainer tests progressive disclosure by ensuring SKILL.md loads quickly and references are loaded only when required.
Quick Start
Create a new skill folder under your plugin's skills/ directory, add SKILL.md with frontmatter and a lean body, and populate optional references/ and examples/ as needed.
