Skill Writing Guide

Overview

Use this guide to create Agent Skills that are easy to discover, quick to load, and reliable in repeated use. A skill should teach an agent how to perform a task, not record how one person solved it once.

When To Use

Use this skill when:

• Creating a new skills/<name>/SKILL.md.
• Reviewing a pull request that adds or changes a skill.
• Turning repeated agent behavior into reusable instructions.
• Deciding whether content belongs in a skill, a script, or regular documentation.

Do not use it for one-off project notes, private runbooks, or generic documentation that agents can already infer from standard tools.

Workflow