writing-skills

Create documentation skills using the RED-GREEN-REFACTOR cycle and TDD methodology.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Himanshu040604/codex-skills-setup --skill writing-skills-himanshu040604
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/Himanshu040604/codex-skills-setup/tree/main/assets/codex/skills/claude-import/skills/plugins/superpowers%40claude-plugins-official/skills/writing-skills
Command: npx skills add https://github.com/Himanshu040604/codex-skills-setup --skill writing-skills-himanshu040604

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

  • TDD for Documentation: Apply the RED-GREEN-REFACTOR cycle to skill writing.
  • Rationalization Countermeasures: Learn to identify and block common excuses agents use to bypass rules.
  • Use Case: When developing a new skill for enforcing coding standards, use this skill's methodology to write failing test scenarios first, then build the skill to address those specific failures, ensuring compliance under pressure.

Quick Start

Follow the RED-GREEN-REFACTOR cycle to write 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 apply Test-Driven Development to skill documentation?

Apply Test-Driven Development to skill documentation by following the RED-GREEN-REFACTOR cycle to write failing test scenarios first, then build the skill to address those specific failures. This ensures skills are discoverable and effective under pressure.

How do I stop AI agents from bypassing rules during skill development?

Stop AI agents from bypassing rules by implementing rationalization countermeasures during skill development. This methodology identifies and blocks common excuses agents use to bypass rules, ensuring strict compliance and robust agent behavior.

What is the best way to test agent behavior for new documentation skills?

The best way to test agent behavior for new documentation skills is by using subagent interaction to validate test scenarios. You write failing tests first, then refine the skill until the agent behaves correctly and passes the tests.

Do I need TDD principles to create and refine documentation skills?

Yes, you need TDD principles to create and refine documentation skills effectively. Understanding the RED-GREEN-REFACTOR cycle is required to ensure your skills are resistant to misuse and rationalization by agents during testing.

How do I ensure my coding standards skill resists rationalization under pressure?

Ensure your coding standards skill resists rationalization by writing failing test scenarios first, then building the skill to address those specific failures. This TDD methodology guarantees compliance and blocks agents from bypassing rules.