Skill Authoring & Documentation FAQs

Question 1

How do I keep skills token-efficient?

Accepted Answer

You can optimize tokens by moving granular details to tool help commands, using cross-references instead of repeating instructions, and compressing code examples to their most minimal form.

Question 2

What is Claude Search Optimization (CSO)?

Accepted Answer

CSO is a set of techniques used to ensure Claude can find and load the correct skill during a session. This includes writing trigger-focused descriptions and using specific keyword coverage.

Question 3

Where are personal Claude skills stored?

Accepted Answer

Personal skills are typically stored in agent-specific directories, such as ~/.claude/skills for Claude Code and ~/.codex/skills for Codex.

Question 4

What is a Claude Code skill?

Accepted Answer

A skill is a specialized reference guide for proven techniques, patterns, or tools that enhances how Claude performs specific tasks within your development environment.

Question 5

Why apply TDD to documentation?

Accepted Answer

Using Test-Driven Development ensures that a skill is actually necessary. By watching an agent fail a pressure scenario before writing the skill, you prove that the documentation provides the specific guidance needed to succeed.

Skill Authoring & Documentation

About

Key Features

Use Cases

Skill Authoring & Documentation

About

Key Features

Use Cases