Skip to content

docs: add OpenCode skill registration to install.md#319

Open
TuanBC wants to merge 1 commit intobrowser-use:mainfrom
TuanBC:docs/add-opencode-install
Open

docs: add OpenCode skill registration to install.md#319
TuanBC wants to merge 1 commit intobrowser-use:mainfrom
TuanBC:docs/add-opencode-install

Conversation

@TuanBC
Copy link
Copy Markdown

@TuanBC TuanBC commented May 7, 2026

Summary

  • Added OpenCode skill registration instructions ($OPN_HOME/skill/browser-harness/SKILL.md)
  • Included Unix symlink command and Windows PowerShell fallback (symlink → copy)
  • Updated final sentence to mention OpenCode alongside Codex and Claude Code

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.

Copilot AI review requested due to automatic review settings May 7, 2026 01:40
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread install.md
Comment on lines +39 to +40
mkdir -p "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness" && ln -sf "$PWD/SKILL.md" "${OPN_HOME:-$HOME/.opencode}/skill/browser-harness/SKILL.md"

Comment thread install.md
Comment on lines +35 to +41
- **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)
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread install.md
Comment on lines +35 to +43
- **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 }
```
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot May 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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>
Suggested change
- **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>

@Alezander9
Copy link
Copy Markdown
Member

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants