Skill Development

To structure a SKILL.md for Claude Code, start with YAML frontmatter containing the skill name and description. Follow this with a concise body written in imperative form, providing procedural guidance for the plugin's execution logic.

Progressive disclosure in Claude skills is an organizational strategy that separates core procedural guidance from bundled resources like scripts, references, and assets. Use it to reduce ambiguity and streamline capability deployment across multiple plugin skills.

The best way to organize bundled resources for a Claude Code skill is to separate them into dedicated directories: scripts/ for executable logic, references/ for documentation, and assets/ for supporting files, ensuring reuse across multiple skills.

Yes, a Claude Code skill requires YAML frontmatter to function properly. The frontmatter must explicitly include the name and description fields to ensure correct discovery, validation, and deployment of the plugin skill within the environment.

You validate and iterate on a Claude Code plugin skill by using guided development workflows. This involves checking that the SKILL.md frontmatter and body are correct, testing bundled scripts and references, and refining the progressive-disclosure content for future deployments.

Yes, you can reuse scripts and references across multiple Claude Code skills. By organizing these bundled resources into standardized directories, teams can support progressive disclosure and share assets efficiently across different plugin deployments.