writing-skills

Apply RED-GREEN-REFACTOR cycles to author and refine documentation skills.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/tunneleven/C4Flow --skill writing-skills-tunneleven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/tunneleven/C4Flow/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/tunneleven/C4Flow --skill writing-skills-tunneleven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework for creating and refining documentation skills, ensuring they are discoverable, effective, and resistant to misuse.

Core Features & Use Cases

  • TDD for Documentation: Applies the RED-GREEN-REFACTOR cycle to skill authoring.
  • Pressure Testing: Develops skills that remain compliant under realistic agent pressures (time, sunk cost, authority).
  • Rationalization Countermeasures: Builds skills that explicitly address and prevent common agent excuses for non-compliance.
  • Use Case: When developing a new skill for code review, you would use this skill to first write scenarios where an agent might skip review steps under pressure, then write the skill to enforce compliance, and finally refine it against new rationalizations.

Quick Start

Use the writing-skills skill to create a new skill document following TDD principles.

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 documentation and skill creation?

Test-driven development for agent documentation applies a RED-GREEN-REFACTOR cycle to skill creation, mandating scenario writing before authoring to ensure compliance and discoverability.

What is the best way to prevent AI agents from skipping compliance steps under pressure?

Preventing agents from skipping compliance steps requires pressure testing skills against realistic constraints like time and sunk cost, then adding rationalization countermeasures to enforce correct behavior.

How do I build agent skills that resist rationalization and misuse?

Building skills that resist rationalization involves explicitly addressing common agent excuses for non-compliance during the authoring process and refining the documentation against new rationalizations.

When do I need to use a TDD framework for refining agent documentation?

A TDD framework for refining agent documentation is needed when developing new skills that must remain effective and compliant under various operational pressures and prevent common compliance failures.

Does pressure testing improve skill discoverability and agent behavior compliance?

Pressure testing improves skill discoverability and agent behavior compliance by rigorously evaluating documentation against realistic constraints, ensuring the final skill remains effective under various pressures.

What are the limitations of using TDD principles for skill development?

Using TDD principles for skill development requires anticipating agent pressures and rationalizations upfront; without accurately predicting these scenarios, the resulting skill may still fail under untested operational conditions.