docs: add OpenCode skill registration to install.md#319
docs: add OpenCode skill registration to install.md#319TuanBC wants to merge 1 commit intobrowser-use:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the installation guide to include OpenCode skill registration so new OpenCode sessions can load browser-harness runtime instructions automatically, alongside existing Codex and Claude Code setup guidance.
Changes:
- Add OpenCode global skill registration instructions pointing to
$OPN_HOME/.../SKILL.md. - Provide Unix symlink command plus a Windows PowerShell symlink-with-copy-fallback snippet.
- Update the concluding sentence to include OpenCode.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| mkdir -p "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness" && ln -sf "$PWD/SKILL.md" "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness/SKILL.md" | ||
|
|
| - **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) |
There was a problem hiding this comment.
1 issue found across 1 file
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="install.md">
<violation number="1" location="install.md:35">
P2: OpenCode install instructions point to the wrong global skill path (`skill`/`~/.opencode`) instead of OpenCode's documented `skills`/`~/.config/opencode` location.</violation>
</file>
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.
| - **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 } | ||
| ``` |
There was a problem hiding this comment.
P2: OpenCode install instructions point to the wrong global skill path (skill/~/.opencode) instead of OpenCode's documented skills/~/.config/opencode location.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At install.md, line 35:
<comment>OpenCode install instructions point to the wrong global skill path (`skill`/`~/.opencode`) instead of OpenCode's documented `skills`/`~/.config/opencode` location.</comment>
<file context>
@@ -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
</file context>
| - **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 } | |
| ``` | |
| - **OpenCode**: add this repo's `SKILL.md` as a global skill under `~/.config/opencode/skills/browser-harness/SKILL.md`. A symlink is fine; on Windows without admin, copy the file instead. | |
| ```bash | |
| # Unix (symlink preferred) | |
| mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/browser-harness" && ln -sf "$PWD/SKILL.md" "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/browser-harness/SKILL.md" | |
| # Windows (PowerShell, symlink needs admin — fall back to copy) | |
| $opn="$env:USERPROFILE\.config\opencode\skills\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 } |
<a href="https://www.cubic.dev/action/fix/violation/0f7a3ea2-8be3-4081-9cb0-be92d79d6b0e" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://cubic.dev/buttons/fix-with-cubic-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://cubic.dev/buttons/fix-with-cubic-light.svg">
<img alt="Fix with Cubic" src="https://cubic.dev/buttons/fix-with-cubic-dark.svg">
</picture>
</a>
|
Please address the bot reviewer comments. This is a good feature if it can be added more carefully and with lower prompt verbosity. Also we have a opencode fork with browser harness built in natively, and it outperforms claude code + harness: https://github.com/browser-use/browsercode |
Summary
$OPN_HOME/skill/browser-harness/SKILL.md)Summary by cubic
Add OpenCode skill registration to install.md so users can register this repo’s SKILL.md globally at
$OPN_HOME/skill/browser-harness/SKILL.md. Includes a Unix symlink command and a Windows PowerShell fallback (copy when symlink needs admin), and updates the final note so Codex, Claude Code, and OpenCode sessions auto-load the browser harness instructions.Written for commit 40d8daa. Summary will update on new commits.