writing-skills

Apply a RED-GREEN-REFACTOR cycle to author and refine agent skill documentation.

1|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/dogekiki/SP-test --skill writing-skills-dogekiki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/dogekiki/SP-test/tree/main/skills/writing-skills
Command: npx skills add https://github.com/dogekiki/SP-test --skill writing-skills-dogekiki

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of inconsistent, unreliable, or poorly understood process documentation by applying Test-Driven Development (TDD) principles to the authoring process.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle to ensure documentation is tested against real-world agent failures.
  • Bulletproofing: Includes techniques for creating rationalization tables and red-flag lists to prevent agents from bypassing rules under pressure.
  • Use Case: Use this when you need to create a new skill or update an existing one to ensure it is robust, discoverable, and actually followed by agents in high-pressure scenarios.

Quick Start

Use the writing-skills framework to create a new skill by first defining a pressure scenario that forces the agent to fail without your documentation.

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 to process documentation?

Applying TDD to process documentation involves using a structured RED-GREEN-REFACTOR cycle to test your instructions against real-world agent failures before finalizing the text. This ensures high reliability under operational pressure.

How do I prevent AI agents from bypassing rules under pressure?

To prevent AI agents from bypassing rules under pressure, author documentation using pressure-testing scenarios and build rationalization tables with red-flag lists. This bulletproofing technique exposes logical loopholes during the writing phase.

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

The RED-GREEN-REFACTOR cycle for skill creation is a Test-Driven Development framework where you first define a failing pressure scenario, then write documentation to make it pass, and finally refine the text for robust compliance.

When should I use a test-driven approach for authoring agent skills?

You should use a test-driven approach for authoring agent skills when creating discipline-enforcing, technique, or pattern-based skills that require high reliability under operational pressure and strict compliance validation.