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.