diff --git a/install.md b/install.md
index 21cc3f51..c948008c 100644
--- a/install.md
+++ b/install.md
@@ -32,7 +32,17 @@ After the repo is installed, register this repo's `SKILL.md` with the agent you
 
 - **Claude Code**: add an import to `~/.claude/CLAUDE.md` that points at this repo's `SKILL.md`, for example `@~/Developer/browser-harness/SKILL.md`.
 
-This makes new Codex or Claude Code sessions in other folders load the runtime browser harness instructions automatically.
+- **OpenCode**: add this repo's `SKILL.md` as a global skill under `$OPN_HOME/skill/browser-harness/SKILL.md` (typically `~/.opencode/skill/browser-harness/SKILL.md`). A symlink is fine; on Windows without admin, copy the file instead.
+
+  ```bash
+  # Unix (symlink preferred)
+  mkdir -p "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness" && ln -sf "$PWD/SKILL.md" "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness/SKILL.md"
+
+  # Windows (PowerShell, symlink needs admin — fall back to copy)
+  $opn="$env:USERPROFILE\.opencode\skill\browser-harness"; New-Item -ItemType Directory -Force -Path $opn | Out-Null; try { New-Item -ItemType SymbolicLink -Path "$opn\SKILL.md" -Target "$PWD\SKILL.md" -Force } catch { Copy-Item "$PWD\SKILL.md" "$opn\SKILL.md" -Force }
+  ```
+
+This makes new Codex, Claude Code, or OpenCode sessions in other folders load the runtime browser harness instructions automatically.
 
 ## Keeping the harness current