writing-skills

Apply the RED-GREEN-REFACTOR cycle to author and refine AI skills.

6|Updated Jan 14, 2020
One-click install
npx skills add https://github.com/SteamedFish/dotfiles --skill writing-skills-steamedfish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/SteamedFish/dotfiles/tree/main/.config/opencode/skills/superpowers/writing-skills
Command: npx skills add https://github.com/SteamedFish/dotfiles --skill writing-skills-steamedfish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured, test-driven approach to creating and refining AI Skills, ensuring they are discoverable, effective, and robust against common failure modes.

Core Features & Use Cases

  • Test-Driven Skill Development: Apply the RED-GREEN-REFACTOR cycle to skill authoring.
  • Rationalization Countermeasures: Learn to identify and block common excuses agents use to bypass rules.
  • Use Case: You need to create a new Skill that enforces a specific coding standard. This Skill guides you through writing test scenarios before writing the Skill itself, ensuring the Skill addresses real-world compliance issues and is resistant to loopholes.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to create a new skill.

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 create new AI skills?

To use TDD for AI skill development, apply the RED-GREEN-REFACTOR cycle by writing test scenarios before authoring the skill. This structured testing methodology ensures the final agent behavior is robust against common rationalizations and compliance failures.

What is the best way to stop agents from bypassing rules?

The best way to stop agents from bypassing rules is to implement rationalization countermeasures during skill development. By identifying common excuses through pressure scenarios, you can add explicit countermeasures that enforce strict compliance with your documentation.

How do I test existing skills for operational integrity before deployment?

You test operational integrity before deployment by applying structured testing and pressure scenarios to existing skills. This verifies their agent behavior against known failure modes and ensures the documentation remains effective and compliant under real-world conditions.

When do I need a test-driven approach to skill development?

You need a test-driven approach to skill development when creating new skills, editing existing ones, or verifying operational integrity before deployment. It ensures your agent behavior and documentation are robust against common rationalizations and compliance failures.

Why do my AI skills fail to enforce coding standards despite explicit rules?

AI skills fail to enforce coding standards because agents often use rationalizations to bypass rules. Addressing these compliance failures requires writing test scenarios before the skill itself to identify loopholes and apply explicit countermeasures.