Skill Development

Create a Claude Code plugin skill by combining YAML frontmatter metadata (name and description) with a Markdown body containing procedural guidance. Use progressive disclosure to organize content across SKILL.md, references, scripts, and assets, ensuring context flows from overview to implementation details.

Progressive disclosure organizes skill content so users encounter foundational concepts first, then deeper details on demand. It reduces cognitive load by distributing information across SKILL.md, bundled references, scripts, and assets rather than overwhelming users upfront.

Bundle skill resources by type: scripts for executable logic, references for supplementary information, and assets for media or data. Reference these components in your SKILL.md using progressive disclosure principles, exposing detailed guidance only when users need it.

Follow standardized guidance on use case definition, trigger phrase design, writing style consistency, and resource organization. Apply progressive disclosure to manage context, validate your skill against actual workflows, and iterate based on user feedback across your Claude Code plugin.

Yes. Refactor existing skills by auditing their YAML metadata, reorganizing Markdown content with progressive disclosure, and consolidating bundled resources (scripts, references, assets). Re-validate against your original use case to ensure consistency.

Define skill metadata with a name and description in YAML frontmatter. Supplement with procedural guidance in the Markdown body. Include bundled references, scripts, or assets as needed. This standardized structure ensures your skill integrates consistently across Claude Code plugins.