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.