How does this help with token efficiency?

It provides strategies like moving details to tool help files, using cross-references, and compressing examples to keep frequently-loaded skills under specific word counts.

Why shouldn't I summarize the skill workflow in the description?

If the description summarizes the process, Claude may follow the summary as a shortcut and skip reading the detailed instructions in the skill body.

What does it mean to apply TDD to writing skills?

It involves a Red-Green-Refactor cycle where you watch an agent fail a task without the skill, write the skill documentation, and then verify the agent complies once the skill is present.

When is the right time to create a new Claude Skill?

Create a skill when you identify a technique that isn't intuitively obvious, applies across multiple projects, and offers a pattern that others would benefit from.

Skill Authoring & Documentation TDD

Name: Skill Authoring & Documentation TDD
Author: claudiodearaujo

byclaudiodearaujo

0•

Herramientas para Desarrolladores

Applies Test-Driven Development principles to create, test, and optimize specialized Claude Code skills.

This skill provides a rigorous framework for building custom Claude Code capabilities by treating documentation as code. By implementing a Red-Green-Refactor cycle for skill creation, it ensures that new instructions actually change agent behavior rather than being ignored. It focuses heavily on Claude Search Optimization (CSO), token efficiency, and the 'Progressive Disclosure' pattern to keep Claude's context window clean while providing high-impact, domain-specific guidance.

Características Principales

01Test-Driven Development (TDD) workflow for documentation

02Validation techniques to ensure agent compliance

03Claude Search Optimization (CSO) for better skill discovery

04Standardized SKILL.md structure and YAML frontmatter

05Token-efficient patterns to minimize context window usage

060 GitHub stars

Casos de Uso

01Optimizing agent behavior across diverse coding projects

02Standardizing documentation for complex internal tools and APIs

03Developing reusable domain-specific patterns for engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro-front writing-skills

For use in Claude.ai and ChatGPT

Download Skill