What problem does it solve?
This Skill solves the problem of creating agent skills that are discoverable, compliant under pressure, and free of loopholes, eliminating wasted effort on documentation that agents ignore, bypass, or misinterpret.
Core Features & Use Cases
- TDD-Adapted Creation Workflow: Applies the RED-GREEN-REFACTOR cycle from test-driven development to process documentation, ensuring skills are tested against real agent behavior before deployment.
- Discovery & Structure Optimization: Provides guidance on YAML frontmatter formatting, description writing for agent discovery, naming conventions, and token-efficient content organization.
- Rationalization Bulletproofing: Includes techniques to resist agent workarounds under pressure, including rationalization tables, red flag lists, and persuasion principle application for discipline-enforcing skills.
- Use Case: For example, if you are creating a skill to enforce test-driven development for your team's coding agent, this skill guides you to first run baseline pressure scenarios to observe how agents skip testing, write minimal guidance addressing those specific failures, then refine the skill until agents comply even when rushing to meet a deadline.
Quick Start
Use the writing-skills skill to create a new skill that enforces running security scans before code deployment, following the TDD workflow to test and refine it until agents follow the rule even when under time pressure to ship a fix.
