opencode-primitives

Purpose

Use this skill whenever OpenWork behavior is implemented directly on top of OpenCode primitives (skills, plugins, MCP servers, opencode.json config, tools/permissions). It anchors decisions to the official OpenCode documentation and keeps terminology consistent in the UI.

Doc Sources (Always cite when relevant)

• Skills: https://opencode.ai/docs/skills
• Plugins: https://opencode.ai/docs/plugins/
• MCP servers: https://opencode.ai/docs/mcp-servers/
• Config (opencode.json, locations, precedence): https://opencode.ai/docs/config/

Key Facts To Apply

Skills

• Skill files live in .opencode/skills/<name>/SKILL.md or global ~/.config/opencode/skills/<name>/SKILL.md.
• Skills are discovered by walking up to the git worktree and loading any matching skills/*/SKILL.md in .opencode/ or .claude/skills/.
• SKILL.md requires YAML frontmatter: name + description.
• Name rules: lowercase alphanumeric with single hyphens (^[a-z0-9]+(-[a-z0-9]+)*$), length 1-64, must match directory name.
• Description length: 1-1024 characters.
• Access is governed by opencode.json permissions (permission.skill allow/deny/ask).