SKILL.md
$27
Plugins
- Local plugins live in
.opencode/plugins/(project) or~/.config/opencode/plugins/(global).
- npm plugins are listed in
opencode.jsonunderpluginand installed with Bun at startup.
- Load order: global config, project config, global plugins dir, project plugins dir.
MCP Servers
- MCP servers are defined in
opencode.jsonundermcpwith unique names.
- Local servers use
type: "local"+commandarray; remote servers usetype: "remote"+url.
- Servers can be enabled/disabled via
enabled.
- MCP tools are managed via
toolsin config, including glob patterns.
- OAuth is handled automatically for remote servers; can be pre-registered or disabled.
Config (opencode.json)
- Supports JSON and JSONC.
- Precedence order: remote
.well-known/opencode-> global~/.config/opencode/opencode.json-> custom path -> projectopencode.json->.opencode/directories -> inline env overrides.
.opencodesubdirectories are plural by default (agents/,commands/,plugins/,skills/,tools/,themes/), with singular names supported for compatibility.
When to Invoke
- Adding or adjusting OpenWork flows that reference skills, plugins, MCP servers, or OpenCode config.
- Designing onboarding guidance that mentions skill/plugin installation, config locations, or permission prompts.
- Implementing UIs that surface OpenCode primitives (skills tab, plugin manager, MCP toggles).
Usage
Call skill({ name: "opencode-primitives" }) before implementing or documenting any OpenWork behavior that maps to OpenCode primitives.