| name | writing-skills |
| description | Use when creating new skills, editing existing skills, or verifying skills work before deployment |
Writing Skills
Directory Structure
Put skills in guidance/skills/, we have linked .agents/skills/ to this folder, so they can be loaded automatically.
guidance/
skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if needed
SKILL.md Structure
---
name: skill-name-with-hyphens
description: "Use when [specific triggering conditions and symptoms]"
---
Other details here
Don't forget the quotes around description.