writing-skills

Create and refine agent Skills using RED-GREEN-REFACTOR cycles.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/jf3096/personal-configs --skill writing-skills-jf3096
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/jf3096/personal-configs/tree/main/.codex/superpowers/skills/writing-skills
Command: npx skills add https://github.com/jf3096/personal-configs --skill writing-skills-jf3096

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven development (TDD) framework for creating and refining agent Skills, ensuring they are effective, discoverable, and resistant to manipulation.

Core Features & Use Cases

  • TDD for Documentation: Apply the RED-GREEN-REFACTOR cycle to Skill development.
  • Pressure Testing: Design scenarios to test Skill compliance under realistic constraints (time, sunk cost, authority).
  • Rationalization Countermeasures: Identify and explicitly address common excuses agents use to bypass rules.
  • Use Case: When developing a new Skill that enforces a critical process (e.g., security checks), use this Skill to ensure the documentation is clear, unambiguous, and robust against common agent rationalizations, preventing security breaches or compliance failures.

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 use TDD to write agent skills that resist rationalization?

Test-driven development for agent skills involves applying RED-GREEN-REFACTOR cycles to documentation, designing pressure scenarios to validate compliance, and explicitly addressing common rationalizations to ensure robust agent behavior.

What is pressure testing for skill compliance and when do I need it?

Pressure testing for skill compliance involves designing scenarios with realistic constraints like time, sunk cost, and authority to validate agent behavior. It is needed when developing skills that enforce critical processes like security checks or compliance rules.

How do I stop an agent from bypassing documentation rules?

To stop an agent from bypassing documentation rules, you identify common excuses used for rationalization and explicitly address them within the skill documentation using structured testing practices to ensure compliance.

Does test-driven development work for skill documentation and discoverability?

Yes, test-driven development works for skill documentation by treating requirements as tests. Following RED-GREEN-REFACTOR cycles ensures documentation is clear, unambiguous, and improves skill discoverability while preventing compliance failures.

What are the limitations of using TDD for skill development?

Limitations of using TDD for skill development include the strict requirement to adhere to RED-GREEN-REFACTOR cycles and the necessity of designing comprehensive pressure scenarios, which demands significant upfront effort for validation.