writing-skills

Applies RED-GREEN-REFACTOR cycle to create and maintain agent skill documentation with explicit testing methodologies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous framework for creating and maintaining high-quality documentation, ensuring that skills are discoverable, effective, and resistant to common rationalizations for bypassing best practices.

Core Features & Use Cases

  • Test-Driven Skill Development: Apply the RED-GREEN-REFACTOR cycle to skill creation, ensuring skills are written only after failing test scenarios are observed.
  • Rationalization Countermeasures: Explicitly address and prevent common excuses agents use to bypass documentation or testing requirements.
  • Use Case: When developing a new skill for code review, you would first run scenarios where an agent doesn't use the skill and document their mistakes. Then, you write the skill to prevent those specific mistakes, and finally, you test again under pressure to ensure compliance.

Quick Start

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

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

To enforce Test-Driven Development for agent skills documentation, apply the RED-GREEN-REFACTOR cycle to mandate baseline failure testing, minimal skill writing, and loophole closure through explicit rationalization counters.

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

Preventing agents from bypassing documentation requires implementing rationalization countermeasures using explicit counters and tables that address common excuses for skipping testing or compliance steps.

How do I apply the RED-GREEN-REFACTOR cycle when developing a new skill?

Apply the RED-GREEN-REFACTOR cycle by first running scenarios without the skill to document mistakes, then writing the skill to prevent those failures, and finally testing under pressure to ensure documentation compliance.

Does test-driven skill development work for different types of agent skills?

Yes, test-driven skill development works for discipline-enforcing, technique, pattern, and reference skill types, utilizing specific testing methodologies tailored to each category's documentation and compliance requirements.

Why do I need rationalization tables when creating agent skills?

Rationalization tables are needed when creating agent skills to close loopholes and explicitly counter common excuses agents use to bypass documentation, ensuring skills remain discoverable and resistant to compliance failures.