Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
TuanBC wants to merge 1 commit into
base: main
Choose a base branch
from
+11 −1
Open

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"

Comment on lines +39 to +40
# Windows (PowerShell, symlink needs admin — fall back to copy)
Comment on lines +35 to +41
$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 }
```
Comment on lines +35 to +43
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot May 7, 2026 •
edited
Loading

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>


This makes new Codex, Claude Code, or OpenCode sessions in other folders load the runtime browser harness instructions automatically.

## Keeping the harness current

Expand Down
Loading