Creating Skills

Overview

Skills are reference guides for proven techniques, patterns, or tools. Write them to help future agents quickly find and apply effective approaches.

Skills must be discoverable (an agent can find them), scannable (quick to evaluate), and actionable (clear examples).

Core principle: Assume the agent already handles general reasoning well. Only add context the agent would not otherwise have.

When to Use

Create a skill when:

• Technique wasn't intuitively obvious
• Pattern applies broadly across projects
• You'd reference this again
• Others would benefit