skills.rest
heyzude
heyzudeCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Guide documentation skill creation through the RED-GREEN-REFACTOR cycle.

4|Updated Feb 13, 2026
Search Tags:#testing#tdd#documentation#refactoring#skill creation#agent behavior
One-click install
npx skills add https://github.com/heyzude/skills_for_codex --skill writing-skills-heyzude
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/heyzude/skills_for_codex/tree/main/superpowers/writing-skills
Command: npx skills add https://github.com/heyzude/skills_for_codex --skill writing-skills-heyzude

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 documentation skills, ensuring they are discoverable, effective, and resistant to misuse.

Core Features & Use Cases

  • Skill Authoring Framework: Guides users through the RED-GREEN-REFACTOR cycle for documentation.
  • Test Case Generation: Helps create pressure scenarios to baseline agent behavior before skill implementation.
  • Rationalization Countermeasures: Provides strategies to close loopholes and prevent agents from bypassing skill rules.
  • Use Case: You need to create a new skill for code review. This skill will guide you through writing test scenarios to see how agents currently perform code reviews without guidance, then help you write the skill to enforce best practices, and finally test it under pressure to ensure compliance.

Quick Start

Use the writing-skills skill when creating new skills, editing existing skills, or verifying skills work before deployment.

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 and refine agent documentation skills?▼

To test skills under pressure, you generate specific pressure scenarios that baseline agent behavior without guidance, then apply the skill to check if it enforces best practices and closes loopholes for bypassing rules.

What is the best way to prevent an agent from bypassing documentation rules?▼

Preventing agents from bypassing documentation rules requires applying rationalization countermeasures during skill refactoring, which systematically closes loopholes and tests agent compliance under pressure scenarios.

How do I baseline agent behavior before writing a new skill?▼

Baselining agent behavior involves creating test cases and pressure scenarios to observe how the agent currently performs tasks without guidance, establishing a reference point for subsequent skill implementation.

Do I need to understand TDD principles to author documentation skills?▼

Understanding TDD principles is required to author documentation skills using this methodology, as the process relies on the RED-GREEN-REFACTOR cycle to iteratively test, implement, and refine agent behavior constraints.

Related Skills

Explore More Software Engineering Skills→
LerianStudioLerianStudio
205

testing-skills-with-subagents

Run baseline failure scenarios to validate skill behavior with RED-GREEN-REFACTOR workflows.

Official
Advanced
IliyaBrookIliyaBrook
114

writing-skills

Apply a Test-Driven Development cycle to author and refine AI skill documentation.

Community
Advanced
viktorbezdekviktorbezdek
10

moai-workflow-testing

Automate end-to-end development workflows integrating testing, debugging, profiling, and code review.

Community
Advanced
nuts-and-bolts-ainuts-and-bolts-ai

writing-skills

Apply RED-GREEN-REFACTOR cycles to author and validate documentation skills.

Official
Advanced