writing-skills

Apply Test-Driven Development cycles to create and refine AI agent Skill documentation.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/nonputtipong/Oryn --skill writing-skills-nonputtipong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/nonputtipong/Oryn/tree/main/.agent/skills/writing-skills
Command: npx skills add https://github.com/nonputtipong/Oryn --skill writing-skills-nonputtipong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating clear, effective documentation (Skills) that AI agents can reliably discover and follow, especially under pressure or when tempted to take shortcuts.

Core Features & Use Cases

  • TDD for Documentation: Applies the Test-Driven Development cycle (Red-Green-Refactor) to the creation and editing of Skills documentation.
  • Pressure Testing: Provides methods to test Skills with agents under various pressures (time, sunk cost, authority) to ensure compliance.
  • Rationalization Countermeasures: Offers strategies to identify and close loopholes that agents use to bypass documentation rules.
  • Use Case: When developing a new Skill for code review, you would use this Skill's methodology to first write scenarios where an agent fails to do a proper review without the Skill, then write the Skill, and finally test it under pressure to ensure it's followed consistently.

Quick Start

Use the writing-skills skill to apply the TDD cycle to create a new skill documentation.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I test AI agent documentation for compliance under pressure?

You test AI agent documentation for compliance by applying pressure scenarios like time constraints, sunk cost, and authority to identify rule bypasses. This ensures your documentation withstands agent attempts to take shortcuts under duress.

What is TDD for documentation and how does it work?

TDD for documentation is a cycle of writing baseline tests for agent failures, implementing minimal skill instructions, and refactoring to close loopholes. It creates robust documentation that agents can reliably discover and follow.

How do I stop AI agents from rationalizing and bypassing skill rules?

You stop AI agents from rationalizing and bypassing skill rules by applying rationalization countermeasures during the refactoring phase. This identifies and closes loopholes that agents use to bypass documentation rules under pressure.

How do I create new skills using the Red Green Refactor cycle?

To create new skills using the Red Green Refactor cycle, first write scenarios where an agent fails without the skill, then write minimal skill instructions for compliance, and finally pressure test the documentation to close loopholes.

Can I use TDD principles to refine existing AI agent skills?

Yes, you can use TDD principles to refine existing AI agent skills by applying pressure testing and rationalization analysis. This process enforces compliance by identifying and closing documentation loopholes during the refactoring stage.

Why does my AI agent fail to follow documentation rules under duress?

AI agents fail to follow documentation rules under duress because of unaddressed rationalization loopholes. You can fix this by pressure testing the documentation with scenarios involving time, sunk cost, and authority to ensure robust compliance.