ZES-writing-skills

Create and verify AI agent skills using a RED-GREEN-REFACTOR cycle.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/ZESCODE/Zes-Orchestration-System --skill zes-writing-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ZES-writing-skills
Source: https://github.com/ZESCODE/Zes-Orchestration-System/tree/main/.agents/skills/ZES-writing-skills
Command: npx skills add https://github.com/ZESCODE/Zes-Orchestration-System --skill zes-writing-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of inconsistent or ineffective agent documentation by applying Test-Driven Development (TDD) principles to the creation of process guides, ensuring agents actually follow instructions under pressure.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle for writing and verifying skill documents.
  • Rationalization Countermeasures: Includes patterns to identify and block agent rationalizations that lead to rule-breaking.
  • Use Case: Use this when you need to create a new skill or update an existing one to ensure that the agent reliably complies with complex workflows or discipline-enforcing rules.

Quick Start

Use the ZES-writing-skills framework to draft a new skill document by first defining a failing pressure scenario and then writing the minimal documentation required to ensure compliance.

Frequently Asked Questions about ZES-writing-skills

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

FAQPage Schema
How do I use TDD for AI agent documentation?▼

TDD for agent documentation uses a RED-GREEN-REFACTOR cycle to write and verify skill documents. You first define a failing pressure scenario, then write the minimal documentation required to ensure the agent reliably complies with complex workflows.

Why does my AI agent break rules under pressure despite clear instructions?▼

Agents break rules under pressure due to rationalization, bypassing instructions when facing conflicting inputs. Countermeasures using a TDD methodology identify and block these rationalizations, ensuring documentation is robust against pressure-induced failure.

What is the best way to standardize AI agent skills creation?▼

Standardizing AI agent skills requires applying a Test-Driven Development methodology to process guides. This approach enforces discipline-enforcing rules and mental models through a structured verification cycle, guaranteeing agents follow technical techniques consistently.

When do I need a test-driven approach for agent skills documentation?▼

You need a test-driven approach for agent skills documentation when creating or updating complex workflows that require strict compliance. It ensures your technical techniques and discipline-enforcing rules hold up against agent rationalization and pressure-induced failure.

Can I update existing agent skills with a TDD methodology?▼

Yes, you can update existing agent skills using TDD methodology. Applying the RED-GREEN-REFACTOR cycle to current documentation verifies its robustness and integrates rationalization countermeasures to prevent future rule-breaking under pressure.

What are the limitations of standard agent documentation without TDD?▼

Standard agent documentation without TDD often fails under pressure, allowing agents to rationalize rule-breaking. It lacks a structured verification cycle to test against failure scenarios, resulting in inconsistent compliance with complex workflows.