Skill Authoring Framework FAQs

Question 1

What is Claude Search Optimization (CSO)?

Accepted Answer

CSO is a set of practices to help Claude find skills efficiently, focusing on triggering-condition descriptions rather than process summaries to avoid context-skipping.

Question 2

When should I create a new skill versus updating CLAUDE.md?

Accepted Answer

Create a skill for reusable techniques, patterns, or tools that apply across multiple projects. Use CLAUDE.md for project-specific conventions.

Question 3

How do I test a new Claude Code skill?

Accepted Answer

By creating a pressure scenario with a subagent, observing the baseline failure (Red), implementing the skill (Green), and then closing loopholes (Refactor).

Question 4

What is the core principle of the Writing Skills framework?

Accepted Answer

The core principle is applying Test-Driven Development to documentation: you must watch an agent fail without the skill to ensure the documentation effectively teaches the right behavior.

Question 5

Why shouldn't the skill description summarize the workflow?

Accepted Answer

Summarizing the workflow in the description can cause Claude to skip the full documentation and follow a simplified, potentially incomplete version of the process.

Skill Authoring Framework

概要

主な機能

ユースケース

Skill Authoring Framework

概要

主な機能

ユースケース