Skills

Skills are reusable capabilities your agents can invoke. They live in your harness’s native format. Karta does not define a separate skill format.

Harness	Skills location
OpenCode	`.opencode/skills/<name>/SKILL.md`; surfaced on `app.skills`.
Claude Code	`.claude/skills/`; preserved in the project and consumed by Claude Code as native harness context.

Question	Answer
Does Karta define a skill schema?	No. Use the harness-native skill format.
Which skills appear on `app.skills`?	OpenCode skills discovered from `.opencode/skills/*/SKILL.md`.
Are Claude Code skills copied into the release?	Yes, as part of the `.claude` project layout. Claude Code owns their runtime behavior.

Defining an OpenCode skill

A skill is a directory with a SKILL.md describing what it does and how to use it, alongside any scripts or resources it needs:

.opencode/skills/
`-- order-lookup/
    `-- SKILL.md

.opencode/skills/order-lookup/SKILL.md

---
name: order-lookup
description: Look up order tracking and delivery status for a customer.
---

Use this skill when a customer asks about an order's status or tracking.
Given an order number, return the current status and estimated delivery.

Binding a skill to an agent

Reference skills from an agent’s frontmatter to grant or scope access:

.claude/agents/shipping.md

---
name: shipping
description: Order status and delivery questions
permissions:
  skill:
    order-lookup: allow
---

You handle shipping questions. Use the order-lookup skill to check status.

Discovery in the SDK

OpenCode skills discovered from .opencode/skills/*/SKILL.md are available on the Karta instance:

app = Karta()
app.skills        # mapping of skill name -> metadata

Verification signal:

assert "order-lookup" in app.skills
assert app.skills["order-lookup"]["path"].endswith("/.opencode/skills/order-lookup/SKILL.md")

Because skills stay in the harness’s native format, the authoritative format and capabilities are the harness’s own. See the Claude Code and OpenCode documentation. Karta’s contribution is preserving the native layout and, for OpenCode, surfacing discovered skills through sessions, routing, and permissions.

Get started

Concepts

Agent project

The CLI

Deploy

Platform

Security

Enterprise

Tutorials

Defining an OpenCode skill

Binding a skill to an agent

Discovery in the SDK

​Defining an OpenCode skill

​Binding a skill to an agent

​Discovery in the SDK

Defining an OpenCode skill

Binding a skill to an agent

Discovery in the SDK