Skill Authoring Framework FAQs

Question 1

Where should I store my custom skills?

Accepted Answer

Personal skills for Claude Code typically live in ~/.claude/skills, while those for Codex live in ~/.codex/skills.

Question 2

What is Claude Search Optimization (CSO)?

Accepted Answer

CSO is a technique to ensure Claude can find the right skill. It focuses on writing descriptions that describe 'triggering conditions' (when to use) rather than summarizing what the skill does.

Question 3

Why use TDD for writing documentation?

Accepted Answer

Applying TDD to documentation ensures the skill is necessary and effective. You write a test scenario, watch the agent fail without the skill (Red), write the skill, and then watch the agent succeed (Green).

Question 4

What is a Claude Code Skill?

Accepted Answer

A Claude Code Skill is a specialized reference guide that provides domain-specific guidance, patterns, and implementation steps to enhance Claude's behavior during specific tasks.

Question 5

How does this skill help with token efficiency?

Accepted Answer

It provides techniques like moving details to tool help commands, using minimal code examples, and using specific cross-referencing patterns to keep skill files under critical token limits.

Skill Authoring Framework

Key Features

Use Cases

Skill Authoring Framework

Key Features

Use Cases