write-a-skill

To create an agent skill, generate a compliant SKILL.md entry point with valid YAML frontmatter and organize instructions into a predictable folder structure with optional reference files and deterministic scripts.

Progressive disclosure in agent skill authoring structures documentation so the SKILL.md entry point provides core instructions, while optional supporting reference files contain detailed documentation to avoid overwhelming the agent.

Package deterministic scripts and reference materials by placing them in a structured skill directory alongside the SKILL.md entry point, ensuring bundled resources support reliable onboarding and execution.

No prior agent framework experience is strictly required to write a skill, but you must clarify the target domain, specific use cases, and whether deterministic scripts are needed during the requirements gathering phase.

The best way to ensure discovery triggers is to include concrete, domain-specific use case descriptions in the YAML frontmatter and SKILL.md content so the agent framework can accurately match the skill to relevant tasks.

A structured skill directory replaces ad-hoc markdown by enforcing consistent folders, YAML frontmatter validation, and progressive disclosure, which produces reusable bundled resources and reliable onboarding.