What does it mean to apply TDD to documentation?

It means you create a 'pressure scenario' where an AI agent is likely to fail, watch it fail (Red), write the skill documentation (Green), and then refine the text to close any remaining loopholes (Refactor).

What is Claude Search Optimization (CSO)?

CSO is the practice of writing skill descriptions and names in a way that helps Claude's internal search mechanism correctly identify and load the right skill for a specific task.

How does this skill help with Claude's context window?

It provides strict token-efficiency targets, such as keeping frequently-loaded skills under 200 words, ensuring you don't waste context on unnecessary instructions.

Can I use this for project-specific instructions?

While it is designed for reusable skills, the TDD principles in this plugin are highly effective for verifying any instructions placed in CLAUDE.md files.

Why should I test a skill with a subagent?

Subagents provide a clean slate. Testing with them ensures your skill is robust enough to guide an agent that doesn't have the immediate context of your current conversation.

Skill Writing & TDD Documentation

Name: Skill Writing & TDD Documentation
Author: apexbusiness-systems

byapexbusiness-systems

0•

学習とドキュメンテーション

Applies Test-Driven Development principles to create and verify robust, loophole-free documentation for Claude Code skills.

The Writing Skills plugin transforms technical documentation into a rigorous engineering process by applying the Red-Green-Refactor cycle. Instead of writing passive instructions, developers create pressure-test scenarios for subagents to identify where AI models rationalize or fail. By witnessing a baseline failure before writing the documentation, users ensure that their Claude Code skills are concise, effective, and resilient against agent non-compliance. It also includes specific optimizations for Claude Search Optimization (CSO) to ensure skills are easily discoverable and context-efficient.

主な機能

01Standardizes modular directory structures for personal and shared skill repositories

02Optimizes skill metadata for Claude Search Optimization (CSO) and discovery

030 GitHub stars

04Enforces token-efficient writing standards to preserve context window space

05Adapts the Red-Green-Refactor cycle specifically for AI process documentation

06Provides subagent pressure-testing techniques to identify rationalization loopholes

ユースケース

01Standardizing team-wide workflows through verified, high-compliance documentation

02Reducing 'context bloat' by refactoring verbose project instructions into concise skills

03Creating reusable AI behavior patterns that work across different projects and sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add apexbusiness-systems/apex-omnihub writing-skills

For use in Claude.ai and ChatGPT

Download Skill