skill-development

Claude Code skills require YAML frontmatter containing name and description, followed by a SKILL.md body written in Markdown with instructions. This structure enforces consistency across skills and enables progressive disclosure of content, starting with metadata, then the skill guide, then optional bundled resources like scripts and references.

Progressive disclosure is a three-level design pattern that presents information incrementally: metadata layer reveals the skill's purpose, SKILL.md body provides core guidance and procedures, and bundled resources offer advanced examples and scripts. This approach reduces cognitive load and lets users engage at their depth level.

Start with YAML frontmatter defining the skill's name and description, write the SKILL.md body as structured Markdown instructions covering core tasks and best practices, then optionally add bundled resources such as scripts or references. Follow the Skill Creation Process and validation patterns to ensure quality and consistency.

Skills require YAML frontmatter metadata, a SKILL.md Markdown body, and optional bundled resources including references and scripts. Organize content using progressive disclosure: expose critical metadata first, then detailed guidance in the body, then supporting assets, enabling users to find and apply what they need.

Yes. Apply the same YAML frontmatter and SKILL.md structure to new or updated skills. Use progressive disclosure and follow quality checks and validation patterns to maintain consistency within the plugin and ensure each skill clearly describes its structure and purpose.

Structure SKILL.md with clear sections, use Markdown formatting for readability, describe the skill's core task and use cases explicitly, provide quick-start examples, and organize procedural steps logically. Enforce progressive disclosure by placing high-level guidance first, then detailed instructions, then edge cases and advanced patterns.