What problem does it solve?
This Skill solves the problem of creating inconsistent, untested, or ineffective skills that fail to guide agent behavior correctly, by applying test-driven development principles to process documentation to ensure skills are bulletproof and function as intended when deployed.
Core Features & Use Cases
- TDD-Adapted Skill Creation Workflow: Maps the RED-GREEN-REFACTOR cycle to skill development, requiring baseline testing of agent behavior before writing skill content to ensure the skill addresses actual agent failures.
- Skill Structure & Discovery Optimization: Provides guidelines for compliant SKILL.md frontmatter, Claude Search Optimization (CSO) to ensure skills are discoverable by future agents, and appropriate file organization for different skill types (technique, pattern, reference).
- Bulletproofing for Discipline Skills: Includes patterns to close agent rationalization loopholes, build rationalization tables, and create red flag lists for skills that enforce strict workflows like TDD or code review requirements.
- Use Case: Use this Skill when you are creating a new reusable skill for your team's workflows, editing an existing skill that agents are not following correctly, or verifying a skill works as intended before sharing it with your team.
Quick Start
Use the writing-skills skill to create a new tested skill for your team's standard code review workflow.