skill-development

Build a Claude Code plugin skill by defining a standard directory skeleton and enforcing YAML frontmatter in SKILL.md. Apply progressive disclosure by relocating detailed guidance, scripts, and examples to bundled references.

Progressive disclosure is a design pattern for Claude Code plugin skills that keeps SKILL.md lean by relocating detailed content, deterministic scripts, and rich context into bundled references and examples directories.

Validate YAML frontmatter for Claude Code plugin skills by checking the mandatory content structure against provided validation criteria. Ensure the root SKILL.md satisfies frontmatter validation before testing.

Your Claude Code plugin skill needs bundled scripts and references to enable deterministic behavior and provide rich context. Reusable resources support maintainability and enforce progressive disclosure.

The best way to audit an existing Claude Code plugin skill is to review the directory structure, relocate detailed guidance to references, and verify SKILL.md satisfies frontmatter validation and imperative writing style.

Move content out of SKILL.md into references when your Claude Code plugin skill requires detailed guidance or examples. This progressive disclosure approach maintains a lean entry point and enforces maintainability.