What is the core principle of the Writing Skills framework?

It treats skill creation as TDD for documentation: you write a test case, watch the agent fail, write the skill, and then verify the agent complies.

What is Claude Search Optimization (CSO)?

CSO is a method of writing skill metadata and descriptions using specific triggering conditions so that Claude can accurately discover and load the right skill at the right time.

How does this skill help with token efficiency?

It provides specific techniques like moving details to tool help, using minimal code examples, and implementing cross-references instead of duplicating content.

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

Summarizing the workflow in the description field can cause Claude to shortcut the process and follow the summary instead of reading the full, detailed skill instructions.

Skill Authoring Framework

Name: Skill Authoring Framework
Author: dkyazzentwatwa

bydkyazzentwatwa

•

Learning & Documentation

Applies Test-Driven Development principles to the creation, optimization, and verification of specialized Claude Code skills.

The Writing Skills framework provides a rigorous methodology for developing Claude Code skills by treating documentation as production code and pressure scenarios as test cases. Using a Red-Green-Refactor cycle, it ensures that new capabilities are only deployed after verifying they solve specific agent failures. The skill emphasizes Claude Search Optimization (CSO) and token efficiency, providing standardized templates and guidelines to create high-performance, discoverable, and context-aware agent extensions.

Key Features

01Test-Driven Development (TDD) workflow for documentation

0229 GitHub stars

03Claude Search Optimization (CSO) triggering strategies

04Pressure-testing methodology using subagent scenarios

05Standardized SKILL.md structural templates and YAML frontmatter

06Token-efficient documentation patterns and cross-referencing

Use Cases

01Creating new reusable agent capabilities with verified compliance

02Refactoring existing skills to reduce token consumption and context bloat

03Standardizing team-wide documentation for complex development workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dkyazzentwatwa/supernavigator writing-skills

For use in Claude.ai and ChatGPT

Download Skill