writing-skills

To write a SKILL.md that triggers Claude reliably, apply a defined frontmatter schema with name and description fields, then structure the body with scope notes, core patterns, and worked examples for consistent skill loading and learning.

The correct frontmatter schema for a SKILL.md file requires name and description fields that drive Claude's loading behavior, ensuring the skill is recognized and applied properly by the validation tooling.

Structure markdown documentation for Claude by sequencing sections with scope notes, core patterns, decision matrices, and worked examples, following progressive disclosure and a 500-line guidance limit with references for edge cases.

Trigger phrases for skill-writing should be demonstrated in the SKILL.md file to define when Claude loads the skill, paired with scope notes and core patterns to guide learning and ensure compatibility with validation tooling.

Writing a SKILL.md specifies structural rules and section sequencing that ensure compatibility with the repository's validation tooling, applying frontmatter requirements and a structured body to pass quality checks.

The 500-line guidance limit for SKILL.md files restricts inline content length, requiring references to deep-dives for edge cases to maintain progressive disclosure while ensuring the file teaches effectively without exceeding structural boundaries.