skill-development

To create a Claude Code plugin skill, add a SKILL.md file with proper frontmatter and a skeleton directory structure, then populate bundled resources in scripts, references, and assets to load content progressively.

SKILL.md frontmatter should include the skill name and description to enable auto-discovery, using an imperative writing style and precise trigger phrases to improve discovery and reliable skill activation.

Organize bundled resources by placing deterministic scripts in the scripts directory, context loading files in references, and output templates in assets to support progressive disclosure and reliable task execution.

Progressive disclosure improves Claude Code skill performance by loading content sequentially: metadata first, then the SKILL.md body, and finally references or assets as needed, keeping the core context lean.

The best way to structure templates and examples for skill development is to apply progressive disclosure layout principles, ensuring frontmatter quality, lean SKILL.md content, and well-referenced resources for reliable activation.

Claude Code plugin skills may not trigger reliably if the SKILL.md frontmatter lacks precise trigger phrases, uses non-imperative writing styles, or contains overly verbose content instead of a lean structure with well-referenced resources.