writing-skills

Apply a RED-GREEN-REFACTOR cycle to create and verify AI skills.

27|1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Till-Crazy-Tears-Us-Apart/Claude-Code-Engineering-Suite --skill writing-skills-till-crazy-tears-us-apart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Till-Crazy-Tears-Us-Apart/Claude-Code-Engineering-Suite/tree/main/skills/writing-skills
Command: npx skills add https://github.com/Till-Crazy-Tears-Us-Apart/Claude-Code-Engineering-Suite --skill writing-skills-till-crazy-tears-us-apart

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that new and updated skills are robust, effective, and adhere to best practices by applying Test-Driven Development (TDD) principles to the skill creation process.

Core Features & Use Cases

  • TDD for Documentation: Adapts the RED-GREEN-REFACTOR cycle for writing and verifying skills.
  • Pressure Testing: Develops and runs scenarios with multiple pressures (time, sunk cost, authority) to test skill compliance.
  • Rationalization Countermeasures: Identifies and explicitly addresses common excuses agents use to bypass rules.
  • Use Case: When creating a new skill to enforce a critical coding standard, use this skill to first demonstrate how agents currently violate the standard without the skill, then write the skill to prevent those specific violations, and finally, test it under pressure to ensure it holds up.

Quick Start

Use the writing-skills skill to create a new skill by first writing a failing test scenario.

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 and verify AI agent skills?

TDD for AI agent skills involves applying a RED-GREEN-REFACTOR cycle to skill documentation and testing methodologies. You first write a failing test scenario demonstrating a current violation, then create the skill to pass it, and finally refactor the documentation.

What is pressure testing for skill compliance?

Pressure testing for skill compliance involves developing and running scenarios with multiple pressures, such as time, sunk cost, and authority, to test if an AI skill maintains its rules. It ensures the agent adheres to standards even under simulated stress.

How do I stop AI agents from rationalizing and bypassing rules?

To stop AI agents from rationalizing and bypassing rules, implement rationalization countermeasures within your skill. This identifies common excuses agents use to skip protocols and explicitly addresses them in the skill documentation to enforce strict compliance.

When should I apply test-driven development to skill documentation?

You should apply test-driven development to skill documentation when creating a new skill to enforce critical coding standards. It is necessary when you need to ensure the skill is robust, effective, and compliant under pressure before deployment.

What is the best way to ensure AI skills are robust and effective?

The best way to ensure AI skills are robust and effective is to enforce Test-Driven Development principles during creation. This approach requires adherence to specific testing protocols and pressure scenario development to verify the skill holds up under stress.