writing-skills

Create and verify agent skills using the RED-GREEN-REFACTOR cycle.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/smrik/ai-fund --skill writing-skills-smrik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/smrik/ai-fund/tree/main/skills/writing-skills
Command: npx skills add https://github.com/smrik/ai-fund --skill writing-skills-smrik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of inconsistent or ineffective documentation by applying Test-Driven Development (TDD) principles to the creation of agent skills, ensuring they are verified against real-world pressure scenarios before deployment.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle for writing and testing skills.
  • Pressure Testing: Includes methodologies for creating scenarios that test agent compliance under time, authority, and sunk-cost pressures.
  • Use Case: Use this when you need to create a new skill that enforces a strict workflow, ensuring that agents don't just "know" the rule, but actually follow it when under stress.

Quick Start

Use the writing-skills framework to define a new skill by first documenting a failing pressure scenario where an agent violates your intended rule.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply TDD to process documentation for agents?▼

You apply TDD to process documentation by using the RED-GREEN-REFACTOR cycle to standardize agent skill creation, writing a failing pressure scenario first to verify compliance before deployment.

What is pressure testing for agent skills?▼

Pressure testing for agent skills is the methodology of creating scenarios that test agent compliance under time, authority, and sunk-cost pressures to ensure strict workflow enforcement.

How do I ensure agents follow strict workflow rules under stress?▼

To ensure agents follow strict workflow rules under stress, you define a new skill by documenting a failing pressure scenario where an agent violates your intended rule, then iterate through the RED-GREEN-REFACTOR cycle.

When do I need TDD for creating procedural guides?▼

You need TDD for creating procedural guides when developing discipline-enforcing documentation and complex procedural guides that require agents to maintain compliance during high-pressure scenarios.

Does this TDD documentation approach require any specific testing frameworks?▼

No, this TDD documentation approach does not require any specific testing frameworks or dependencies, utilizing internal scripts to standardize creation and verification of agent skills.