write-a-skill

To create custom agent skills for Claude Code, you need a well-formed SKILL.md file with valid YAML frontmatter and agent-discoverable descriptions. This skill enforces standardized structure and proven authoring best practices to generate optimized, reusable tools.

Progressive disclosure in skill authoring is the practice of splitting large content into reference files and adding utility scripts only when needed. This approach keeps the main SKILL.md optimized for agent discoverability while maintaining scalable, reusable tooling.

Structuring a SKILL.md file for workflow automation requires valid YAML frontmatter, clear description triggers for agent discovery, and organized workflow steps. This skill guides you through requirement gathering, drafting, and review to ensure consistent structure.

Yes, you can bundle optional utility scripts and reference files with your custom tools for AI coding agents. This skill provides templates and rules for adding these components only when needed, ensuring your SKILL.md remains clean and effective.

The best way to ensure agent discoverability for productivity skills is to define clear description triggers and valid YAML frontmatter within a standardized SKILL.md structure. This skill eliminates inconsistent formatting by enforcing proven authoring best practices.

Custom Claude Code skills fail to trigger reliably due to inconsistent structure and poor agent discoverability. This skill solves the problem by enforcing standardized SKILL.md formatting, valid YAML frontmatter, and clear description triggers for seamless integration.