superpowers-writing-skills

Apply the RED-GREEN-REFACTOR cycle to create and edit agent skills.

37|12|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/exiao/skills --skill superpowers-writing-skills-exiao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-writing-skills
Source: https://github.com/exiao/skills/tree/main/superpowers-writing-skills
Command: npx skills add https://github.com/exiao/skills --skill superpowers-writing-skills-exiao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill ensures that new and updated agent skills are robust, well-tested, and resistant to common failure patterns and rationalizations, preventing the deployment of ineffective or buggy skills.

Core Features & Use Cases

  • Test-Driven Development for Skills: Applies the RED-GREEN-REFACTOR cycle to skill documentation.
  • Pressure Testing: Develops realistic scenarios to test skill compliance under various pressures (time, sunk cost, authority).
  • Rationalization Countering: Identifies and explicitly addresses common excuses agents use to bypass skill rules.
  • Use Case: Before deploying a new skill that enforces coding standards, you would use this skill to write failing tests (e.g., scenarios where an agent might skip a standard), then write the skill to make the agent comply, and finally, test against new rationalizations to ensure the skill remains effective.

Quick Start

Use the superpowers-writing-skills skill to ensure your new skill is rigorously tested before deployment.

Frequently Asked Questions about superpowers-writing-skills

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

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

TDD for agent skills applies the RED-GREEN-REFACTOR cycle to documentation by writing failing scenario tests first, then creating skill rules to ensure agent compliance, and finally refactoring to prevent rationalization loopholes.

What is test-driven development for skill documentation?

Test-driven development for skill documentation is a methodology adapting the RED-GREEN-REFACTOR cycle to enforce robustness and compliance, ensuring new agent skills are rigorously tested against realistic scenarios before deployment.

How do I prevent an AI agent from bypassing skill rules?

Prevent agents from bypassing skill rules by identifying common rationalizations and explicitly addressing them through pressure testing, closing loopholes in documentation under constraints like time or sunk cost.

When should I use pressure testing for skill development?

Use pressure testing for skill development when validating compliance before deployment, specifically to test how an agent handles realistic scenarios under pressures like time constraints, sunk costs, and authority.

Does this TDD methodology work for existing skill refactoring?

Yes, this TDD methodology applies to the entire skill lifecycle, allowing you to refactor existing agent skills by adapting the RED-GREEN-REFACTOR cycle to update documentation and ensure ongoing compliance.