Create and refine documentation skills using the RED-GREEN-REFACTOR test-driven cycle.
npx skills add https://github.com/flosrn/.claude --skill writing-skills-flosrn
Please help me install this Agent Skill. Skill: writing-skills Source: https://github.com/flosrn/.claude/tree/main/skills/writing-skills Command: npx skills add https://github.com/flosrn/.claude --skill writing-skills-flosrn
This Skill provides a structured, test-driven approach to creating and refining documentation skills, ensuring they are discoverable, effective, and resistant to misuse.
SKILL.md, you'll write test scenarios to see how an agent naturally reviews code without the skill (RED), then write the skill to enforce best practices (GREEN), and finally, test against common rationalizations like "it's faster to just commit" (REFACTOR).Use the writing-skills skill when you are about to create a new skill document.
High-intent search queries and answers about installing and using this skill.
Test-driven skill creation applies the RED-GREEN-REFACTOR cycle to documentation, writing test scenarios for agent behavior first, then refining the skill to enforce best practices and resist rationalization bypasses.
RED-GREEN-REFACTOR for documentation skills involves testing baseline agent behavior without the skill, writing the skill to enforce desired compliance, and then refactoring against pressure scenarios to block rationalizations.
To stop AI agents from bypassing documentation, apply rationalization countermeasures during skill testing, identifying and blocking common excuses like claiming speed improvements to skip required steps.
Pressure scenario tests evaluate documentation skills by simulating edge cases where agents might deviate, ensuring the skill maintains compliance and discoverability under rationalization pressure.
You need to apply TDD to skill development before writing a new SKILL.md document, ensuring you establish baseline agent behavior first to effectively enforce and iterate on compliance.
The best way to ensure skill discoverability and compliance is iterating through test-driven development, validating agent behavior against pressure scenarios to refine the documentation and prevent misuse.
caobingshengGenerate failing tests to define expected behavior in the TDD red phase.
Till-Crazy-Tears-Us-ApartApply a RED-GREEN-REFACTOR cycle to create and verify AI skills.
simonheimlicherAudit SKILL.md frontmatter, XML structure, and content quality against official guidelines.
jmdueaCreate, edit, and validate Claude skills with TDD-style guidelines and pressure-scenario templates.