writing-skills

Create documentation skills using the RED-GREEN-REFACTOR TDD cycle.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bitranox/skills --skill writing-skills-bitranox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/bitranox/skills/tree/main/writing-skills
Command: npx skills add https://github.com/bitranox/skills --skill writing-skills-bitranox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven development (TDD) approach to creating and refining documentation skills, ensuring they are effective, discoverable, and resistant to rationalization.

Core Features & Use Cases

  • TDD for Documentation: Apply the RED-GREEN-REFACTOR cycle to skill creation.
  • Pressure Testing: Design scenarios that simulate real-world constraints to test skill compliance.
  • Rationalization Countermeasures: Develop explicit strategies to prevent agents from bypassing rules.
  • Use Case: When developing a new skill that enforces a critical coding standard (like TDD), use this skill to write failing test scenarios first, then build the documentation to make agents comply, and finally, refactor to close any loopholes agents might exploit under pressure.

Quick Start

Follow the TDD cycle to create a new skill documentation.

Frequently Asked Questions about writing-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use TDD to write documentation for AI agents?

To use TDD for documentation, write failing test scenarios that simulate agent rationalizations, then build the documentation to enforce compliance. This RED-GREEN-REFACTOR cycle ensures your skill instructions remain effective under real-world pressure.

What is agent rationalization in skill creation?

Agent rationalization occurs when AI bypasses rules under pressure. This skill counters it by developing explicit strategies and test scenarios that simulate constraints, closing loopholes agents might exploit when following documentation.

How do I pressure test documentation skills for compliance?

Pressure testing documentation involves designing scenarios that simulate real-world constraints to verify skill compliance. You create situations that trigger agent rationalizations, ensuring your documentation holds up and enforces rules effectively.

Can I apply the RED-GREEN-REFACTOR cycle to content creation workflows?

Yes, you can apply the RED-GREEN-REFACTOR cycle to content creation workflows. Write failing test scenarios first, create documentation to pass them, and refactor to close loopholes, ensuring robust and reliable documentation outputs.

When do I need a test-driven approach for skill creation?

You need a test-driven approach for skill creation when developing documentation that enforces critical coding standards. It ensures your skills are effective, discoverable, and resistant to agents bypassing rules under real-world pressure.

How to prevent AI agents from bypassing documentation rules?

To prevent AI agents from bypassing rules, use rationalization countermeasures. Write failing test scenarios exposing loopholes first, then build documentation to close them, and refactor to ensure strict compliance under simulated pressure.