writing-skills

Apply the RED-GREEN-REFACTOR cycle to create and refine AI agent Skills.

1|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/mihaamiharu/twe --skill writing-skills-mihaamiharu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/mihaamiharu/twe/tree/main/.agent/skills/writing-skills
Command: npx skills add https://github.com/mihaamiharu/twe --skill writing-skills-mihaamiharu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework for creating and refining process documentation (Skills), ensuring they are effective, discoverable, and resistant to misuse.

Core Features & Use Cases

  • TDD for Documentation: Applies the RED-GREEN-REFACTOR cycle to Skill authoring.
  • Pressure Testing: Develops scenarios to test Skill compliance under realistic constraints (time, sunk cost, authority).
  • Rationalization Countermeasures: Identifies and explicitly addresses common excuses agents use to bypass rules.
  • Use Case: When developing a new Skill that enforces a critical testing procedure, use this Skill's methodology to ensure agents adhere to TDD principles even when under pressure to ship quickly.

Quick Start

Follow the RED-GREEN-REFACTOR cycle outlined in this Skill's documentation to create a new Skill.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply TDD principles to AI agent skill development?

To apply TDD to skill development, follow the RED-GREEN-REFACTOR cycle. Write a failing test for the skill's expected behavior, create the skill to pass the test, and then refine the skill to improve compliance and discoverability.

What is pressure testing for AI agent documentation?

Pressure testing for agent documentation involves creating scenarios with realistic constraints like time pressure, sunk costs, and authority to ensure the AI agent adheres to the defined skill rules and TDD principles even under stress.

How do I stop AI agents from bypassing documentation rules?

Stop agents from bypassing rules by implementing rationalization countermeasures that identify and explicitly address common excuses agents use to skip steps, ensuring your skill remains bulletproof against misuse.

What is the RED-GREEN-REFACTOR cycle for skill authoring?

The RED-GREEN-REFACTOR cycle for skill authoring requires writing a failing test for the desired agent behavior, creating the skill documentation to pass that test, and then refactoring the skill to ensure effectiveness and compliance.

Do I need prior TDD knowledge to use test-driven documentation?

Yes, you need prior understanding of Test-Driven Development principles, pressure scenarios, and psychological principles of persuasion to effectively develop bulletproof skills and process documentation.