Skills

Skills teach the agent domain-specific knowledge and workflows. They are Markdown files that the agent reads before starting a task.

What Are Skills?

A skill is a reusable instruction set written in Markdown. Skills can cover coding standards, architecture decisions, deployment procedures, or anything else the agent should know.

Writing Skills

Create a .md file in your project's .opencode/skills/ directory. Use frontmatter for metadata:

---
name: "API Design Guide"
description: "Conventions for REST API endpoints"
---

## Endpoint naming
Use plural nouns: /users, /products...

Managing Skills

Enable, disable, or reorder skills from the Skills panel in Settings. The agent loads enabled skills at session start.