writing-skills

Apply RED-GREEN-REFACTOR cycles to create and refine AI agent documentation.

4|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/alixex/aryxn --skill writing-skills-alixex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/alixex/aryxn/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/alixex/aryxn --skill writing-skills-alixex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework for creating and refining documentation (Skills) to ensure they are discoverable, effective, and resistant to misuse by AI agents.

Core Features & Use Cases

  • Test-Driven Skill Development: Apply the RED-GREEN-REFACTOR cycle to documentation.
  • Rationalization Countermeasures: Explicitly address and prevent AI agents from bypassing rules through logical fallacies or workarounds.
  • Use Case: When developing a new skill for code review, use this skill to first write scenarios where an agent fails to perform a proper review without the skill, then write the skill to enforce the correct process, and finally test against pressures like tight deadlines or manager overrides.

Quick Start

Use the writing-skills skill to create a new skill document following test-driven development principles.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I enforce test-driven development for AI agent documentation?

Test-driven documentation enforces agent behavior by applying a RED-GREEN-REFACTOR cycle, requiring baseline failure testing and minimal viable documentation before iterative refinement against rationalizations.

What is the best way to prevent AI agents from bypassing documentation rules?

Preventing AI agents from bypassing documentation rules requires explicit rationalization countermeasures that test against logical fallacies and workarounds under pressures like tight deadlines or manager overrides.

How does test-driven skill development improve agent compliance?

Test-driven skill development improves compliance by first writing scenarios where an agent fails without the skill, then writing the skill to enforce the correct process through structured testing protocols.

Can I use test-driven documentation for existing AI agent workflows?

Yes, you can refine existing AI agent workflows by iteratively refactoring documentation against rationalizations, ensuring baseline failure testing and minimal viable documentation requirements are satisfied.

When do I need to apply rationalization countermeasures in skill development?

Rationalization countermeasures are needed when AI agents face operational pressures that cause them to bypass rules, requiring structured testing protocols to ensure discoverability, compliance, and robustness.