writing-skills

Apply RED-GREEN-REFACTOR cycles to author and verify agent skills.

1|Updated Oct 12, 2025
One-click install
npx skills add https://github.com/sunmin-oss/sunmin-oss --skill writing-skills-sunmin-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/sunmin-oss/sunmin-oss/tree/main/.copilot/skills/writing-skills
Command: npx skills add https://github.com/sunmin-oss/sunmin-oss --skill writing-skills-sunmin-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of inconsistent or ineffective agent documentation by applying Test-Driven Development (TDD) principles to the creation of 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 testing skills against agent rationalizations and real-world constraints like time, authority, and exhaustion.
  • Use Case: Use this skill when you need to create a new agent capability or update an existing one and want to guarantee that the agent will actually follow the instructions under high-pressure conditions.

Quick Start

Use the writing-skills framework to define a new skill by first creating a failing pressure scenario and then documenting the required behavior.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I apply Test-Driven Development to agent skills documentation?

Test-Driven Development for agent skills documentation applies a structured RED-GREEN-REFACTOR cycle to author and verify instructions. It enforces baseline testing and pressure scenario validation to ensure agent compliance before deployment.

What is pressure testing for AI agents and when do I need it?

Pressure testing for AI agents validates skill instructions against real-world constraints like time, authority limits, and exhaustion. You need it to close loopholes and prevent agent rationalizations when operating under high-stress conditions.

How do I stop AI agents from rationalizing and skipping instructions?

To stop AI agents from rationalizing, you implement explicit anti-rationalization patterns during the skill authoring process. Structured TDD frameworks enforce these patterns by validating behaviors against pressure scenarios before deployment.

Can I use TDD to verify process improvement for existing agent capabilities?

Yes, you can use TDD to verify process improvement for existing agent capabilities by defining a failing pressure scenario and documenting the required behavior. This ensures updates are validated against real-world constraints.

Does writing-skills require external testing dependencies to validate documentation?

No, writing-skills does not require external testing dependencies to validate documentation. It operates independently using internal scripts to facilitate the RED-GREEN-REFACTOR cycles and pressure scenario validation.

What are the limitations of using TDD for quality assurance in agent documentation?

A limitation of using TDD for quality assurance in agent documentation is that it requires defining explicit pressure scenarios upfront. Without accurately anticipating real-world constraints, baseline testing may not cover all edge cases.