writing-skills

Create process documentation for AI agents using test-driven development cycles.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sammy9322/ventura-dental-facturacion --skill writing-skills-sammy9322
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/sammy9322/ventura-dental-facturacion/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/sammy9322/ventura-dental-facturacion --skill writing-skills-sammy9322

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skills are often written without testing, causing agents to ignore them or find loopholes under pressure. This skill provides a test-driven development framework for creating process documentation that agents actually follow.

Core Features & Use Cases

  • TDD for Skills: Apply RED-GREEN-REFACTOR cycles to documentation instead of code.
  • Pressure Testing: Use subagent scenarios to verify skills resist rationalization under time, sunk cost, and authority pressures.
  • Discovery Optimization: Write descriptions and structure skills so agents find and use them correctly.
  • Use Case: A developer creating a TDD enforcement skill can baseline agent behavior, write minimal documentation addressing specific failures, and bulletproof it against common excuses like "I'll test later" or "I already manually tested it."

Quick Start

Use the writing-skills skill to create a new skill by running a baseline pressure scenario without the skill, then writing minimal documentation that addresses the exact failures you observed.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I write AI agent documentation that agents actually follow under pressure?

Test-driven development for AI agent documentation involves running baseline pressure scenarios without the skill, observing specific agent failures, and writing minimal process documentation that addresses those exact failures. This approach ensures AI agents follow instructions even under time, sunk cost, and authority pressures.

What is test-driven development for skill authoring and how does it work?

Test-driven development for skill authoring applies RED-GREEN-REFACTOR cycles to process documentation instead of code. It uses pressure scenarios and rationalization tables to test that AI agent skills resist loopholes, ensuring documentation enforces compliance when agents face stress conditions like time pressure or sunk cost bias.

How do I test AI agent skills against rationalization and loopholes?

You test AI agent skills against rationalization by using subagent pressure scenarios that simulate time constraints, sunk cost bias, and authority pressure. The writing-skills approach baselines agent behavior without the skill, then verifies that documentation prevents common excuses like skipping tests or claiming manual testing sufficed.

Can I use TDD principles to create enforcement skills for AI agent systems?

Yes, you can use TDD principles to create enforcement skills for AI agent systems by applying RED-GREEN-REFACTOR cycles to documentation. This approach suits discipline-enforcing skills, technique guides, pattern references, and API documentation requiring compliance verification under stress conditions like deadline pressure or authority override attempts.

What is the best way to optimize AI agent skill discovery and usage?

The best way to optimize AI agent skill discovery is through structured documentation writing that applies discovery optimization techniques. By crafting descriptions and skill structures specifically for agent comprehension, you ensure AI systems find and correctly use process documentation when following test-driven development workflows.

Why do AI agents ignore process documentation under pressure and how can I prevent it?

AI agents ignore process documentation under pressure when skills lack testing against rationalization scenarios. You prevent this by applying test-driven development to authoring, using pressure tests for time and authority biases, and building rationalization tables that address common excuses like deferring tests or claiming manual verification is sufficient.