Writing Skills

Overview

Skills are reusable reference guides that help AI agents find and apply effective techniques. A skill is NOT a narrative - it's a pattern, technique, or reference that applies broadly.

When to Use

• Creating a new skill from a discovered technique
• Editing or improving an existing skill
• Reviewing skill quality before deployment
• Unsure if something should be a skill vs project-specific docs

Don't create skills for: one-off solutions, project-specific conventions (use AGENTS.md), or things enforceable via automation.

File Structure