Claude Skills

1 min read

Claude Skills (Agent Skills)

OpenCode supports "Agent Skills," often compatible with the "Claude Skills" format. These are reusable definitions that teach the agent how to perform specific tasks or behaviors, effectively expanding the agent's capabilities.

What is a Skill?

A Skill is essentially a directory containing a SKILL.md file (and potentially other resources). This markdown file defines:

  • Description: What the skill does.
  • Instructions: Step-by-step guides for the agent.
  • Examples: How to use the skill.

How to Add Skills

OpenCode looks for skills in several locations. You can add them globally or per-project.

Project-level:

  • .opencode/skill/<skill-name>/SKILL.md
  • .claude/skills/<skill-name>/SKILL.md (Compatible with Claude Code structure)

Global-level:

  • ~/.config/opencode/skill/<skill-name>/SKILL.md
  • ~/.claude/skills/<skill-name>/SKILL.md

Usage

Once a skill is placed in one of these directories, the agent can "discover" it.

  • The agent can see available skills via the native skill tool.
  • When a task requires that specific knowledge, the agent loads the full content of the SKILL.md to guide its actions.

This allows you to share common workflows (e.g., "How to write a migration in our specific framework") across your team or projects without repeating instructions in every prompt.