skill-writing

To write a SKILL.md file, use a structured blueprint enforcing frontmatter correctness, progressive disclosure, and quality gates to ensure governance compliance and discoverability. This approach standardizes content structure for Claude Code agents.

Progressive disclosure in skill writing is a workflow that guides authors through phased content creation, ensuring complex governance criteria and validation checks are met incrementally. It prevents overwhelming users while maintaining structure.

Validate SKILL.md entries by applying quality gates and TDD-based writing disciplines to check frontmatter formats, 500-line limits, and search-optimized keywords. This ensures discoverability and safety compliance.

Writing SKILL.md requires standardized frontmatter containing name and description fields to ensure proper governance and discoverability. Adherence to these frontmatter formats is strictly enforced throughout the creation process.

The best way to optimize Claude prompts for search discoverability is aligning persuasion principles and incorporating search-optimized keywords within the SKILL.md structure. This ensures compliance while maximizing visibility.

Your SKILL.md exceeds the 500-line limit when governance criteria are not properly applied through progressive disclosure and cross-referencing. Adhering to the phased workflow and structural guidelines prevents this violation.