writing-skills

Test-driven development for skill documentation applies a RED-GREEN-REFACTOR cycle to creation, using baseline tests, implementation, and rationalization tracking to ensure guidelines are tested and validated.

The RED-GREEN-REFACTOR cycle for writing agent skills involves writing baseline RED tests, achieving GREEN implementation to pass them, and executing a REFACTOR loop to optimize structure and track rationalization.

Skill creation requires a minimal frontmatter schema containing only name and description fields, ensuring clear discovery and structured evaluation before deployment readiness checks are performed.

To test documentation against rationalization, apply pressure scenarios during the testing phase and use rationalization tracking to keep guidelines resistant to subjective interpretation and safe for production.

Yes, you can update tested skills in production environments by following the test-driven workflow, ensuring safe updates are deployed only after passing structured evaluation and deployment readiness checks.

Skill writing supports progressive disclosure patterns and CSO-aligned discovery, structuring documentation so guidelines are revealed contextually while maintaining clear evaluation and deployment readiness standards.