writing-skills

Author agent skills using a RED-GREEN-REFACTOR cycle with pressure-based test scenarios.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/NeuralChainX/Superpowers --skill writing-skills-neuralchainx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/NeuralChainX/Superpowers/tree/main/skills/writing-skills
Command: npx skills add https://github.com/NeuralChainX/Superpowers --skill writing-skills-neuralchainx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of inconsistent, unreliable, or poorly followed process documentation by applying the rigor of Test-Driven Development (TDD) to the authoring of skills themselves.

Core Features & Use Cases

  • TDD for Documentation: Provides a structured RED-GREEN-REFACTOR cycle to ensure skills are tested against real-world agent rationalizations before deployment.
  • Rationalization Countermeasures: Includes patterns for identifying and closing loopholes that agents use to bypass instructions under pressure.
  • Use Case: Use this when you need to create a new skill that enforces a complex discipline (like TDD or security protocols) and want to ensure the agent will actually follow it under high-pressure scenarios.

Quick Start

Use the writing-skills framework to create a new skill by first running a baseline pressure scenario to document agent failures.

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 process documentation?

Test-Driven Development for process documentation applies a structured RED-GREEN-REFACTOR cycle to author and verify agent skills. You write discipline-enforcing docs, test them against pressure scenarios, and refactor to close rationalization loopholes.

What is the best way to prevent AI agents from rationalizing and bypassing instructions under pressure?

To prevent agent rationalization under pressure, author documentation using pressure-based test scenarios. This framework identifies and closes loopholes agents exploit to bypass instructions, enforcing strict compliance with complex disciplines like security protocols.

How do I create agent skills that enforce complex disciplines reliably?

Creating reliable agent skills requires applying a TDD framework with a RED-GREEN-REFACTOR cycle. You author discipline-enforcing documentation and verify it against real-world agent rationalizations to guarantee compliance under high-pressure scenarios.

When do I need a TDD framework for authoring agent skills?

You need a TDD framework for authoring agent skills when creating documentation that must resist agent rationalization under pressure. It is essential for enforcing complex disciplines like TDD or security protocols where strict adherence is critical.

How do I start writing documentation using a RED-GREEN-REFACTOR cycle?

Start writing documentation using a RED-GREEN-REFACTOR cycle by running a baseline pressure scenario to document agent failures. This establishes the initial test case to build and refactor your discipline-enforcing documentation against.

What are the limitations of using pressure-based test scenarios for documentation?

Pressure-based test scenarios for documentation require strict adherence to the RED-GREEN-REFACTOR cycle and are limited by their reliance on predefined rationalization patterns. They may not anticipate entirely novel agent behaviors outside the tested pressure scenarios.