diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 217abf0..9196320 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -17,7 +17,7 @@ jobs:
           bun-version: latest
 
       - name: Install
-        run: bun install --frozen-lockfile
+        run: bun install --frozen-lockfile --ignore-scripts
 
       - name: Lint
         run: bun run lint
diff --git a/README.md b/README.md
index cfee610..bc8caba 100644
--- a/README.md
+++ b/README.md
@@ -40,8 +40,15 @@ Add the plugin to your `opencode.json`:
 }
 ```
 
-The following command files are automatically copied to
-`~/.config/opencode/command/` on installation:
+> [!CAUTION]
+> **One-time setup required**: OpenCode does not execute npm postinstall scripts.
+> Run this command once after initial installation to enable slash commands:
+>
+> ```bash
+> cd ~/.cache/opencode/node_modules/opencode-agent-modes && node dist/postinstall.js
+> ```
+
+The following command files are copied to `~/.config/opencode/command/`:
 
 - `mode-performance.md`
 - `mode-economy.md`