writing-skills

Guide AI agent skill creation through a RED-GREEN-REFACTOR testing cycle.

Updated Nov 13, 2025
One-click install
npx skills add https://github.com/466852675/TISHICIKU-2025 --skill writing-skills-466852675
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/466852675/TISHICIKU-2025/tree/main/07-Skill%E5%BA%93/writing-skills
Command: npx skills add https://github.com/466852675/TISHICIKU-2025 --skill writing-skills-466852675

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create and refine documentation (Skills) by applying rigorous testing and iterative development principles, ensuring clarity, accuracy, and effectiveness.

Core Features & Use Cases

  • Test-Driven Skill Development: Guides you through writing tests before writing the skill documentation itself.
  • Rationalization Countermeasures: Provides strategies to prevent AI agents from bypassing documentation rules under pressure.
  • Iterative Refinement: Encourages a RED-GREEN-REFACTOR cycle for documentation, similar to code development.
  • Use Case: You're creating a new Skill for code review. This Skill will guide you to first write scenarios where an AI fails to do a good review without your Skill, then write the Skill to fix that failure, and finally test it against new pressures to ensure it holds up.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to create or update a skill document.

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 AI agent skills and documentation?

Test-driven skill development involves writing baseline failure scenarios before creating the documentation, then applying a RED-GREEN-REFACTOR cycle to iteratively refine the AI agent skill until it passes.

What is the RED-GREEN-REFACTOR cycle for documentation?

The RED-GREEN-REFACTOR cycle for documentation is a testing methodology where you write failing baseline tests, create minimal skill documentation to pass them, and then iteratively refactor for robustness.

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

To prevent AI agents from bypassing documentation rules under pressure, you apply rationalization countermeasures by testing the skill against new pressures to ensure strict compliance.

How to refactor AI agent skills to ensure documentation robustness?

Refactoring AI agent skills involves iteratively refining the documentation after passing baseline tests, ensuring it maintains robustness and compliance when subjected to new testing pressures.

Does test-driven skill development support reference and technique skill types?

Yes, test-driven skill development supports discipline-enforcing, technique, pattern, and reference skill types by providing specific testing strategies tailored to each documentation format.

When should I not use TDD for documentation?

TDD for documentation may not suit rapidly drafted, low-stakes process notes where iterative baseline testing and rationalization countermeasures add unnecessary overhead to the writing process.