writing-skills

To standardize skill authoring, draft a SKILL.md file enforcing mandatory frontmatter fields like name and description, ensuring machine-discoverable metadata and safe deployment. This approach improves reliability and reuse across teams.

The best way to structure scalable skill workflows is progressive disclosure: organize inline content and optional resources like scripts, references, and assets logically, ensuring safe usage and discoverability without overwhelming the user.

Frontmatter validation ensures safe usage and discoverability by enforcing a clear metadata contract with mandatory fields, applying safety considerations, and aligning with quality assurance patterns to verify skills behave under evaluation.

No specific dependencies are required to organize scripts and references for skill creation. The guide demonstrates an optional resource layout for larger skills, allowing flexible integration of assets within the structured metadata framework.

Skills fail evaluation testing after updating documentation guidelines when they lack alignment with RED-GREEN-REFACTOR quality assurance patterns. Validate your SKILL.md frontmatter and structured metadata against the testing workflow to ensure correct behavior.