writing-skills

Document and validate reusable skills by applying a strict RED-GREEN-REFACTOR TDD workflow to authoring SKILL.md files. This standardizes frontmatter, enforces safety checks, and ensures content validation.

The required SKILL.md frontmatter structure must include mandatory name and description fields. YAML frontmatter validation also enforces specifying dependencies, components, and toxicity declarations.

Create a new skill by following the test-driven workflow: write validation tests first, create the SKILL.md structure to pass them, then refactor. This enforces progressive disclosure and lightweight inline content.

Yes, skill authoring requires declaring dependencies and components in the YAML frontmatter. The validation workflow enforces these safety checks to properly rationalize skill integration.

The best way to structure skill validation documentation is using progressive disclosure with lightweight inline content. Use heavy references when needed to pass strict TDD validation checks efficiently.