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.