WORKFLOWS

Skill authoring requires gerund naming (lowercase, hyphens, max 64 chars), third-person descriptions under 1024 chars with explicit triggers, and a SKILL.md under 500 lines. Progressive disclosure keeps the main file concise while detailed content lives in structured sub-files referenced one level deep.

Evaluation-driven development builds tests and scenarios before writing content. This workflow ensures quality gates are met pre-release and helps authors iterate efficiently by establishing clear acceptance criteria upfront rather than testing after implementation.

Progressive disclosure structures Skills with a concise SKILL.md overview and references to detailed files organized hierarchically one level deep. This keeps the main file scannable while making comprehensive information accessible without overwhelming initial readers.

Skills require lowercase hyphenated names (max 64 chars, no reserved words), third-person descriptions stating triggers and key terms within 1024 chars, and a table of contents for SKILL.md files exceeding standard length to support usability.

Pre-release quality gates validate that naming, descriptions, triggers, and file hierarchies meet standards before publication. Governance checkpoints catch structural and content issues early, reducing iteration cycles and ensuring consistent author experience.