writing-skills

To write reliable SKILL.md documentation, apply a test-driven development workflow that enforces structured authoring and validation cycles before deployment. This ensures predictable discovery and loading by agents.

Test-driven development for skill creation applies RED-GREEN-REFACTOR cycles to draft SKILL.md content, capture tests, and refactor to close loopholes. Documenting failures and rationalizations ensures predictable behavior.

The best way to validate a SKILL.md file is executing a RED-GREEN-REFACTOR cycle to verify its structure and behavior. This workflow requires documenting failures and explicit counters to ensure reliable discovery by agents.

Yes, you can edit existing documentation using a TDD workflow. The process applies to creating new Skills, editing existing ones, and verifying them before deployment across teams to ensure well-scoped and tested content.

Yes, you need to document test failures, rationalizations, and explicit counters when writing skills. This requirement ensures the SKILL.md is well-scoped, tested, and ready for predictable discovery and loading by agents.