What is the TDD approach for writing skills?

The TDD approach involves creating a 'pressure scenario' to watch an agent fail (Red), writing the skill documentation (Green), and then refining the documentation to close loopholes (Refactor).

How do I keep my Claude skills token-efficient?

You can save tokens by using cross-references to other skills, moving technical details to tool help commands, and using minimal, high-impact code examples.

Why is description formatting important for Claude Search Optimization?

If a description summarizes the workflow instead of just the triggering conditions, Claude may follow the limited summary and skip reading the full instructions in the skill body.

What is the difference between a technique and a pattern skill?

A technique provides concrete steps to follow for a specific task, while a pattern describes a general way of thinking about or structuring complex problems.

When should I create a new skill versus updating a project file?

Create a skill for reusable techniques and patterns that apply across projects; use project files (like CLAUDE.md) for local conventions and one-off solutions.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: ehartye

byehartye

0•

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

Standardizes the creation of Claude Code skills using Test-Driven Development principles to ensure agent compliance and efficiency.

This skill provides a rigorous framework for authoring high-quality Claude Code skills by applying Test-Driven Development (TDD) to process documentation. It guides users through the Red-Green-Refactor cycle—testing agent failure before writing the skill, verifying compliance after implementation, and refining documentation to close loopholes. By focusing on Claude Search Optimization (CSO) and token efficiency, it ensures that new capabilities are easily discoverable and performant without bloating the context window, making it an essential tool for developers building complex agentic workflows.

主な機能

01Claude Search Optimization (CSO) guidelines for discovery

02Standardized SKILL.md structure and YAML frontmatter

030 GitHub stars

04Guidance on flowchart usage and cross-referencing

05Token-efficient formatting and content compression

06TDD-based documentation workflow (Red-Green-Refactor)

ユースケース

01Creating reusable domain-specific guidance for Claude Code

02Refining existing skills to prevent agent 'shortcuts' or hallucinations

03Standardizing documentation across large agent-based projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ehartye/hartye-superpowers writing-skills

For use in Claude.ai and ChatGPT

Download Skill