writing-skills

You document reusable skills using a test-driven approach by applying a RED-GREEN-REFACTOR lifecycle to process documentation, enforcing baseline testing, minimal skill creation, counters, and red flags to ensure quality and repeatability.

The RED-GREEN-REFACTOR workflow for skill creation is a test-driven lifecycle that establishes baseline testing, builds a minimal skill, implements counters, and flags issues to verify reusable guidance before deployment.

You validate skill deployments across teams by enforcing structured YAML frontmatter with a name and description, running skill-testing workflows, and checking deployment readiness alongside rationalization tracking.

Yes, writing reusable process documentation requires YAML frontmatter containing a name and description to enforce structure, support progressive disclosure, and enable keyword-rich discovery for skill validation.

The best way to track rationalizations when editing existing skills is to document them structurally alongside cross-references and red flags, ensuring the modified guidance remains test-verified and deployment-ready.

You should avoid a test-driven approach for skill documentation when creating disposable or one-off instructional content that does not require repeatability, deployment readiness checks, or cross-team validation.