Skill Development

To structure a SKILL.md file for Claude Code plugin development, you must include mandatory name and description YAML frontmatter, followed by lean core content. This ensures smooth loading and auto-discovery conventions are met for your plugin.

Progressive disclosure in Claude Code skills is a design approach that balances lean core SKILL.md content with rich bundled context. It organizes optional references, assets, and scripts separately to optimize loading context and streamline skill creation.

The step-by-step Claude Code skill creation process involves outlining use cases, drafting a SKILL.md file with proper YAML frontmatter, populating bundled resources like references, and performing validation checks to ensure compliance and smooth loading.

Yes, AgentStack plugin development requires YAML frontmatter validation. Enforcing frontmatter validity and adherence to writing style conventions ensures your plugin skills load smoothly and integrate correctly within the AgentStack ecosystem.

You should use bundled references instead of inline content in SKILL.md when you need to provide rich context without bloating the core file. This progressive disclosure strategy optimizes loading context by keeping the main SKILL.md lean.

Your Claude Code skill may fail auto-discovery due to invalid YAML frontmatter, non-compliant writing style, or improper resource referencing. Enforcing validation checks and adhering to structural conventions ensures smooth loading and successful plugin integration.