writing-skills

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

7|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/carl10086/ys-powers --skill writing-skills-carl10086
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/carl10086/ys-powers/tree/main/skills/writing-skills
Command: npx skills add https://github.com/carl10086/ys-powers --skill writing-skills-carl10086

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 the creation and maintenance of skills.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle for writing and verifying skills.
  • Rationalization Prevention: Includes techniques to identify and counter 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 it is bulletproof, verifiable, and resistant to agent shortcuts under pressure.

Quick Start

Use the writing-skills skill to guide the creation of a new documentation skill using the TDD cycle.

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 for process documentation to prevent agent rationalization?

TDD for process documentation prevents agent rationalization by enforcing a strict RED-GREEN-REFACTOR cycle during skill creation. This cycle pressure-tests your documentation to ensure consistent agent compliance and resistance to rule-breaking shortcuts under pressure.

What is the RED-GREEN-REFACTOR cycle for agent skill development?

The RED-GREEN-REFACTOR cycle is a Test-Driven Development framework for authoring and refining agent skills. It structures documentation creation sequentially to verify rules are followed and to resist rationalizations that lead to inconsistent agent behavior.

How do I create bulletproof documentation that resists agent shortcuts under pressure?

Create bulletproof documentation by applying Test-Driven Development principles to skill authoring and maintenance. This approach identifies and counters agent rationalizations, ensuring your documentation remains verifiable and resistant to shortcuts under pressure.

Does writing-skills work with existing skill updates or only new documentation?

writing-skills works with both existing skill updates and new documentation creation. It requires adherence to the RED-GREEN-REFACTOR cycle for all skill development and maintenance tasks, ensuring any updates remain bulletproof and verifiable against rationalization.

When should I use a TDD framework for documentation compliance?

Use a TDD framework for documentation compliance when you need to ensure your agent skills are bulletproof and verifiable. It is specifically designed to counter rationalizations that lead to rule-breaking during high-pressure scenarios or complex maintenance tasks.