diff --git a/docs/opencode-setup.md b/docs/opencode-setup.md
index f43fe78..84a96d5 100644
--- a/docs/opencode-setup.md
+++ b/docs/opencode-setup.md
@@ -4,7 +4,7 @@ This guide explains how to use Agent Skills with OpenCode in a way that closely
 
 ## Overview
 
-OpenCode does not support plugins or native slash commands like `/spec` or `/plan`.
+OpenCode supports custom `/commands`, but does not have a native plugin system or automatic skill routing like Claude Code.
 
 Instead, we achieve parity through:
 
@@ -14,6 +14,14 @@ Instead, we achieve parity through:
 
 This creates an **agent-driven workflow** where skills are selected and executed automatically.
 
+While it is possible to recreate `/spec`, `/plan`, and other commands in OpenCode, this integration intentionally uses an agent-driven approach instead:
+
+- Skills are selected automatically based on intent
+- Workflows are enforced via `AGENTS.md`
+- No manual command invocation is required
+
+This more closely matches how Claude Code behaves in practice, where skills are triggered automatically rather than manually.
+
 ---
 
 ## Installation