OpenCode Platform Reference

Verified against OpenCode docs on 2026-06-14.

Sources:

Skills

OpenCode discovers skills from:

.opencode/skills/<name>/SKILL.md
.claude/skills/<name>/SKILL.md
.agents/skills/<name>/SKILL.md

Recognized frontmatter:

---
name: skill-name
description: Clear trigger and scope.
license: MIT
compatibility: opencode
metadata:
  owner: kandev
---

Only name and description are required. Unknown frontmatter fields are ignored. name must match the directory name and match:

^[a-z0-9]+(-[a-z0-9]+)*$

Description must be 1-1024 characters.

Agents

Launch project workers with OpenCode's native Task tool. Kandev MCP task or session APIs must not be used as an OpenCode subagent fallback.

OpenCode supports JSON config and Markdown agent files.

Project Markdown agents:

.opencode/agents/<name>.md

Markdown example:

---
description: Reviews code for quality and best practices.
mode: subagent
temperature: 0.1
permission:
  edit: deny
  bash:
    "*": ask
    "git diff": allow
    "git log*": allow
---

Only analyze code and suggest changes.

The Markdown filename becomes the agent name.

JSON example:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "mode": "subagent",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "permission": {
        "edit": "deny"
      }
    }
  }
}

Important fields:

description is required.
mode: primary, subagent, or all; default is all.
model: provider/model-id format when explicitly pinned.
temperature: lower for planning/review; higher for brainstorming.
steps: max agentic iterations; legacy maxSteps is deprecated.
permission: use this instead of deprecated tools.
hidden: hide a subagent from autocomplete.
permission.task: restrict which subagents another agent can invoke.

Kandev maintains only the read-only .opencode/agents/pr-poller.md, using DeepSeek Flash for an explicitly user-authorized PR wait. When the user explicitly requests another project agent, retain the selected primary model unless they choose otherwise and set permission.task deliberately to control recursive delegation.

OpenCode temperature controls sampling randomness, not reasoning effort. With model unpinned, provider-specific reasoning settings also remain inherited from the primary agent. Do not map Kandev role effort to temperature.

Rules

OpenCode uses AGENTS.md for project instructions. It also has Claude-compatible fallbacks:

Project rules: CLAUDE.md if no AGENTS.md exists.
Project skills: .claude/skills/ and .agents/skills/ as compatibility paths.

Prefer AGENTS.md as the shared project source of truth.

3.0 KiB Raw Blame History

OpenCode Platform Reference

Skills

Agents

Rules

3.0 KiB

Raw Blame History