writing-skills

Test Claude Skills documentation by executing a RED-GREEN-REFACTOR workflow that runs baseline failure analysis, minimal skill creation, and verification checks to ensure deployment readiness before publishing or updating.

The RED-GREEN-REFACTOR workflow for skill writing is a test-driven approach where RED establishes baseline failure analysis, GREEN creates minimal skill documentation to pass tests, and REFACTOR applies explicit countermeasures to close loopholes.

Track rationalizations that bypass skill documentation rules by documenting the exact rationalizations agents use during subagent pressure scenarios, then building a red-flag system with targeted countermeasures to prevent future evasion.

You need YAML frontmatter with name and description fields to write and validate a SKILL.md file. The skill documentation process assumes this required frontmatter structure while allowing optional references to extended guides.

The best way to verify deployment readiness for Claude Skills is to apply deployment checklists and meta-testing patterns across multiple passes, ensuring pressure scenarios pass GREEN verification and rationalization countermeasures are enforced before publishing.