writing-skills

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

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Luizfbm/Dev-roast --skill writing-skills-luizfbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Luizfbm/Dev-roast/tree/main/.agents/skills/writing-skills
Command: npx skills add https://github.com/Luizfbm/Dev-roast --skill writing-skills-luizfbm

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 process guides.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle to ensure skills are tested before deployment.
  • Rationalization Prevention: Includes techniques to identify and counter agent excuses for skipping steps.
  • Use Case: Use this when you need to create a new skill or update an existing one to ensure it is bulletproof, verifiable, and resistant to agent shortcuts.

Quick Start

Use the writing-skills skill to guide the creation and testing of a new process document using the TDD cycle.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use TDD to write documentation for agent skills?

To use TDD for documentation, apply the structured RED-GREEN-REFACTOR cycle to standardize agent skill creation. This verifies process guides before deployment, ensuring they are bulletproof and resistant to agent shortcuts.

What is the RED-GREEN-REFACTOR cycle for process documentation?

The RED-GREEN-REFACTOR cycle is a TDD framework applied to documentation to test process guides before deployment. It enforces discipline by requiring explicit loophole closure, ensuring agents comply with steps under pressure.

How do I prevent agents from skipping steps in process documentation?

Prevent agents from skipping steps by applying rationalization prevention techniques during documentation creation. This identifies and counters agent excuses, explicitly closing loopholes to enforce compliance under pressure.

When should I use test-driven development for creating agent skills?

Use test-driven development for creating agent skills when you need to update existing guides or build new ones. It ensures your process documentation is verifiable, bulletproof, and resistant to agent shortcuts before deployment.

What are the limitations of using TDD principles for documentation?

A limitation of TDD for documentation is the strict requirement to adhere to the RED-GREEN-REFACTOR cycle and explicitly close loopholes. This rigorous process demands thorough rationalization prevention to ensure agent compliance under pressure.