writing-skills

Guide AI Skill creation and refinement using a Test-Driven Development cycle.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/northseadl/skillwisp --skill writing-skills-northseadl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/northseadl/skillwisp/tree/main/skills/%40obra/writing-skills
Command: npx skills add https://github.com/northseadl/skillwisp --skill writing-skills-northseadl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven development (TDD) methodology specifically for creating and refining AI Skills, ensuring they are effective, discoverable, and robust against rationalization.

Core Features & Use Cases

  • TDD for Skills: Adapts the RED-GREEN-REFACTOR cycle to skill authoring.
  • Pressure Testing: Provides frameworks for testing skills under realistic agentic pressures (time, sunk cost, authority).
  • Rationalization Countermeasures: Offers strategies to prevent agents from bypassing skill rules.
  • Use Case: When developing a new skill for code review, use this TDD approach to first demonstrate how agents currently bypass reviews, then write the skill to enforce compliance, and finally, test against common excuses agents might use to skip reviews.

Quick Start

Follow the RED-GREEN-REFACTOR cycle outlined in this skill 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 build robust AI skills?

TDD for AI skills adapts the RED-GREEN-REFACTOR cycle to skill authoring by first demonstrating agent failures, writing the skill to enforce compliance, and iteratively refactoring. This structured testing ensures skills remain robust and discoverable.

What is agent rationalization in skill development?

Agent rationalization occurs when AI bypasses skill rules under realistic agentic pressures like time, sunk cost, or authority. It is countered by applying structured pressure testing frameworks during skill development to enforce compliance.

How do I pressure test an AI skill against agent rationalization?

Pressure testing an AI skill involves evaluating it under realistic agentic pressures such as time constraints, sunk costs, and authority. This process uses structured testing frameworks to identify and counter common excuses agents use to bypass rules.

Does this TDD methodology work for different types of AI skills?

Yes, this TDD methodology provides specific testing strategies for various skill types, including discipline-enforcing, technique, pattern, and reference skills, ensuring comprehensive coverage across different agent behaviors and use cases.

Why do AI agents bypass documentation and review rules?

AI agents bypass documentation and review rules due to rationalization under agentic pressures. Applying a test-driven development approach with rationalization countermeasures prevents these common excuses and enforces strict rule compliance.