writing-skills

Apply the RED-GREEN-REFACTOR cycle to author and refine agent process documentation.

2|Updated May 27, 2026
One-click install
npx skills add https://github.com/edlng/agents --skill writing-skills-edlng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/edlng/agents/tree/main/skills/claude/writing-skills
Command: npx skills add https://github.com/edlng/agents --skill writing-skills-edlng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of inconsistent or ineffective process documentation by applying Test-Driven Development (TDD) principles to ensure your instructions are reliable, verifiable, and resistant to agent rationalization.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle for creating and maintaining process guides.
  • Rationalization Defense: Includes techniques to identify and block common agent excuses for skipping steps or violating rules.
  • Use Case: Use this when you need to create a new agent skill or update an existing one to ensure it is bulletproof and actually followed by the agent under pressure.

Quick Start

Use the writing-skills framework to create a new skill by first running a baseline test to document agent failures and then writing the documentation to address those specific issues.

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 process documentation for AI agents?

Apply TDD to process documentation by running a baseline test to capture agent failures, then write instructions to fix those specific issues using the RED-GREEN-REFACTOR cycle.

What is the best way to stop agents from rationalizing and skipping steps in documentation?

The best way to stop agent rationalization is using a TDD framework for documentation that identifies and blocks common excuses for skipping steps or violating rules under pressure.

When do I need to apply test-driven development principles to agent skills?

You need test-driven development for agent skills when creating a new discipline-enforcing skill or updating an existing one to ensure instructions remain reliable and compliant under high-pressure scenarios.

How does the RED-GREEN-REFACTOR cycle work for refining agent instructions?

The RED-GREEN-REFACTOR cycle for agent instructions works by documenting baseline failures, writing rules to make the agent pass, and refactoring to eliminate rationalization loopholes.

Does writing-skills require any specific dependencies or testing frameworks to start?

Writing-skills requires no external dependencies, using only included scripts to implement the TDD framework for authoring and refining verifiable process documentation.

Why does my agent skill documentation fail to enforce the process during high-pressure scenarios?

Process documentation fails under pressure when it lacks rationalization defense, which a TDD framework addresses by testing for agent failures and refining instructions to eliminate loopholes.