Skills are reusable prompt modules. Each skill lives in a folder inside your workspace at .agents/skills/[name]/SKILL.md. The agent loads them when the task matches.

Structure

Create a folder under .agents/skills/ with the skill name, and add a SKILL.md file inside it.

your-workspace/
└── .agents/
    └── skills/
        └── code-review/
            └── SKILL.md

SKILL.md format

YAML frontmatter for the name and description, followed by markdown instructions.

---
name: code-review
description: Review code for bugs, style issues, and best practices
---

# Code Review

When reviewing code, focus on:
- Bug detection
- Performance issues
- Security vulnerabilities

Follow the project's coding conventions.

name is the unique identifier. description tells the agent when to use the skill. Everything after the frontmatter is markdown instructions injected into the conversation when the skill is loaded.