Skill Development

To structure SKILL.md frontmatter for a Claude Code plugin, include third-person name and description fields. This ensures the skill meets discovery requirements and can be accurately indexed by the platform.

Progressive disclosure in Claude Code skill development is the practice of moving heavy details into separate references and examples. This keeps the main SKILL.md body lean and maintainable while preserving comprehensive guidance.

The best way to organize reusable scripts within a plugin skill is to bundle them as dedicated assets alongside your references. This separates executable tooling from core markdown guidance, ensuring clean resource structuring and maintainability.

Packaging a Claude Code skill requires following lifecycle guidance from initialization to iteration. You draft frontmatter, organize content into a lean SKILL.md, add detailed references or scripts, and finalize the bundle for deployment.

You do not need to include executable scripts directly in your SKILL.md file. You should keep the markdown body lean with core guidance and include optional executable scripts or assets as separate bundled files when needed.

Your Claude Code skill fails discovery requirements if its frontmatter lacks a proper name and description. Ensure the SKILL.md includes these mandatory fields along with a concise markdown body to satisfy platform indexing.