writing-skills

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

114|6|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/IliyaBrook/figma-linux --skill writing-skills-iliyabrook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/IliyaBrook/figma-linux/tree/main/.claude/skills/writing-skills
Command: npx skills add https://github.com/IliyaBrook/figma-linux --skill writing-skills-iliyabrook

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 documentation (Skills), ensuring they are discoverable, effective, and robust against rationalization.

Core Features & Use Cases

  • TDD for Documentation: Adapts the Red-Green-Refactor cycle to skill authoring.
  • Pressure Testing: Develops scenarios to test skill compliance under realistic constraints.
  • Rationalization Countermeasures: Provides techniques to bulletproof skills against AI workarounds.
  • Use Case: When developing a new skill for code review, use this Skill to first define failure scenarios (e.g., agent skips review under time pressure), then write the skill to enforce the review, and finally test against new rationalizations (e.g., "I'll review it later").

Quick Start

Use the writing-skills skill to create a new skill by following the TDD process outlined in its documentation.

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 write AI skills documentation?

Writing AI skills with TDD involves creating failing baseline tests for non-compliance, authoring minimal skills to pass them, and refactoring to close loopholes using pressure scenarios and rationalization countermeasures.

What are rationalization countermeasures in AI skill development?

Rationalization countermeasures in AI skill development are techniques used to bulletproof skills against AI workarounds. They test skill compliance under realistic constraints, preventing the AI from skipping instructions or using excuses like "I'll review it later."

Can I apply test-driven development to all types of AI skills?

Yes, you can apply test-driven development to all AI skill types, including discipline-enforcing, technique, pattern, and reference skills. The methodology adapts the Red-Green-Refactor cycle to ensure discoverability and effectiveness across any documentation format.

What is the best way to pressure test AI skills for compliance?

The best way to pressure test AI skills for compliance is to develop realistic scenarios where the agent might skip instructions, such as under time pressure. You then evaluate the skill against these constraints and apply rationalization countermeasures to close loopholes.

Why does my AI agent skip instructions in skill documentation?

AI agents skip instructions when skill documentation contains rationalization loopholes. Prevent this by using a TDD methodology to define failure scenarios, write minimal enforcing constraints, and test against new rationalizations.