writing-skills

Guide AI skill creation and testing with a TDD methodology.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/J03Fr0st/maestro --skill writing-skills-j03fr0st
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/J03Fr0st/maestro/tree/main/.github/skills/writing-skills
Command: npx skills add https://github.com/J03Fr0st/maestro --skill writing-skills-j03fr0st

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a rigorous, test-driven framework 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 development.
  • Pressure Testing: Uses realistic scenarios with multiple pressures (time, sunk cost, authority) to uncover weaknesses.
  • Rationalization Countermeasures: Explicitly addresses common excuses agents use to bypass rules.
  • Use Case: When developing a new skill for code review, you would use this skill's methodology to write failing test scenarios, then build the skill to pass those tests, and finally refactor to prevent agents from skipping steps under pressure.

Quick Start

Follow the RED-GREEN-REFACTOR cycle outlined in this skill's documentation 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 test AI skills using a Test-Driven Development methodology?

To test AI skills with TDD, adapt the RED-GREEN-REFACTOR cycle to documentation by writing failing pressure scenarios first, then building the skill to pass those tests, and refactoring to enforce rules against rationalization.

What is a rationalization table in AI skill development?

A rationalization table is a countermeasure used in AI skill development to explicitly address common excuses agents use to bypass rules, ensuring skills remain robust and effective under realistic pressure scenarios.

How do I pressure test an AI skill for robustness and discoverability?

Pressure test an AI skill by applying realistic scenarios with multiple pressures like time, sunk cost, and authority to uncover weaknesses, ensuring the skill enforces explicit rules and remains effective under stress.

Does TDD for AI skills work with discipline-enforcing and reference skill types?

TDD for AI skills applies to all skill types, including discipline-enforcing, technique, pattern, and reference skills, ensuring each variant is robust, discoverable, and effective against rule rationalization.

Why do AI agents bypass skill rules under pressure during testing?

AI agents bypass skill rules under pressure due to rationalization, using common excuses to skip steps when facing time, sunk cost, or authority pressures, which is why explicit rule enforcement and rationalization countermeasures are needed.

What is the best way to create robust AI skills that resist rationalization?

The best way to create robust AI skills is using a test-driven framework that employs pressure scenarios and rationalization tables, ensuring the skills are effective, discoverable, and enforce explicit rules under stress.