skills.rest
will-flemmer
will-flemmerCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Apply Test-Driven Development cycles to create and refine Claude Skills.

Updated Aug 23, 2026
Search Tags:#testing#best practices#documentation#TDD#AI agent#skill authoring#rationalization
One-click install
npx skills add https://github.com/will-flemmer/claude-config --skill writing-skills-will-flemmer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/will-flemmer/claude-config/tree/main/skills/meta/writing-skills
Command: npx skills add https://github.com/will-flemmer/claude-config --skill writing-skills-will-flemmer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that every new or updated Claude Skill is robust, clear, and effective by applying Test-Driven Development (TDD) principles to documentation, preventing agents from rationalizing away critical instructions and ensuring consistent compliance.

Core Features & Use Cases

  • TDD for Documentation: Guides you through a RED-GREEN-REFACTOR cycle to test skill effectiveness against agent behavior before deployment.
  • Rationalization Prevention: Identifies and counters common agent "excuses" and loopholes to ensure compliance under pressure.
  • Claude Search Optimization (CSO): Provides best practices for naming, descriptions, and keywords to maximize skill discoverability and relevance.
  • Skill Structure Guidelines: Offers detailed advice on organizing SKILL.md content, including frontmatter, sections, and token efficiency.
  • Use Case: You're creating a new skill that enforces a strict coding standard. This skill helps you design it so that Claude consistently adheres to the standard, even when under time pressure, by anticipating and addressing potential rationalizations.

Quick Start

To create a new skill, first identify a problem where Claude might fail without your skill. Run a baseline scenario without the skill and document Claude's exact rationalizations. Then, write the minimal skill to address those failures. Re-test and refine until Claude consistently complies, closing any new loopholes it finds.