skill-development

Structure a Claude Code plugin skill by using a lean SKILL.md with frontmatter and deferring heavy content to modular resource directories like references/, examples/, scripts/, and assets/.

Progressive disclosure in skill development is an organizational strategy that keeps SKILL.md lean by bundling heavy domain knowledge into separate resource directories, allowing Claude to load detailed content on demand.

Create a new Claude Code skill by populating a SKILL.md file with required frontmatter, writing a third-person description, defining explicit trigger phrases, and organizing supporting content into modular resource directories.

Valid Claude Code plugin skills require frontmatter containing at least the name and description fields, ensuring the skill artifact is properly identified and can be loaded by Claude within the plugin ecosystem.

Yes, Claude Code skills should be validated before packaging to ensure they conform to plugin-dev conventions, including proper frontmatter presence, lean SKILL.md content, and correct references to bundled resources.

The best way to write Claude Code skill descriptions is using the imperative form and a third-person perspective, ensuring the text clearly defines explicit trigger phrases for when the skill should be activated.