writing-skills

Write and test AI skill documentation using Test-Driven Development principles.

5|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/zhexulong/bdd-superpowers --skill writing-skills-zhexulong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/zhexulong/bdd-superpowers/tree/main/skills/writing-skills
Command: npx skills add https://github.com/zhexulong/bdd-superpowers --skill writing-skills-zhexulong

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you create, maintain, and test process documentation using the principles of Test-Driven Development (TDD), ensuring clarity and effectiveness.

Core Features & Use Cases

  • Test-Driven Documentation: Write and refine skills by first documenting failure cases and then addressing those with your skill documentation.
  • Skill Creation: Guides you through the creation of new skills, including naming conventions, description fields, and structuring the content.
  • Skill Testing: Provides a framework for testing skills against pressure scenarios, ensuring they resist rationalization and enforce correct behavior.

Quick Start

To create a new skill, follow these steps:

  1. Define the problem you're addressing with the skill.
  2. Write a failing test (pressure scenario) for the problem.
  3. Write the skill to address the failing test.
  4. Refactor the skill to close any loopholes found during testing.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I use test-driven development for AI skill documentation?

Test-driven development for AI skill documentation involves writing a failing pressure scenario first, then creating the skill to address that failure, and finally refactoring to close loopholes. This ensures clear, actionable guidance and effective compliance.

What is the best way to structure process documentation for AI skills?

The best way to structure process documentation for AI skills is by defining the problem first, applying test-driven development to validate against pressure scenarios, and enforcing correct behavior through continuous refactoring to prevent rationalization.

How do I test AI skills against pressure scenarios to enforce correct behavior?

To test AI skills against pressure scenarios, you write specific failing test cases that attempt to rationalize or bypass rules, then refine the skill documentation until it successfully resists these scenarios and enforces the correct behavior.

Do I need to understand TDD principles to create and test process documentation?

Yes, you need to understand TDD principles to create and test process documentation, as the methodology requires defining failure cases first, addressing them with skill documentation, and refactoring to ensure effective compliance.

What steps are involved in creating new skills using a TDD methodology?

Creating new skills using TDD requires defining the problem, writing a failing test or pressure scenario, writing the skill to address the failing test, and refactoring the skill to close any loopholes found during testing.

Why does test-driven development help maintain clear and actionable process documentation?

Test-driven development helps maintain clear and actionable process documentation by forcing you to document failure cases first, ensuring the final skill directly addresses known issues and resists rationalization during pressure scenario testing.