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

•

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

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.

主な機能

Test-Driven Development (TDD) workflow for documentation
29 GitHub stars
Claude Search Optimization (CSO) triggering strategies
Pressure-testing methodology using subagent scenarios
Standardized SKILL.md structural templates and YAML frontmatter
Token-efficient documentation patterns and cross-referencing

ユースケース

Creating new reusable agent capabilities with verified compliance
Refactoring existing skills to reduce token consumption and context bloat
Standardizing team-wide documentation for complex development workflows

概要

主な機能

Test-Driven Development (TDD) workflow for documentation
29 GitHub stars
Claude Search Optimization (CSO) triggering strategies
Pressure-testing methodology using subagent scenarios
Standardized SKILL.md structural templates and YAML frontmatter
Token-efficient documentation patterns and cross-referencing

ユースケース

Creating new reusable agent capabilities with verified compliance
Refactoring existing skills to reduce token consumption and context bloat
Standardizing team-wide documentation for complex development workflows