diff --git a/README.md b/README.md
index 5cf4e81..2bdc1f5 100644
--- a/README.md
+++ b/README.md
@@ -47,14 +47,17 @@ extension.
## Quick Start
+### 1. Install the CLI and skill
+
Install with your Agent (recommended)
-Already using Cursor, Claude Code, Codex, or another shell-capable agent? Just
-copy this one line and send it to your agent — it will install the CLI and skill
-for you, then walk you through loading the extension:
+Already using Cursor, Claude Code, Codex, WorkBuddy, or another shell-capable
+agent? Just copy this one line and send it to your agent — it will install the
+CLI and skill for you. You will install the browser extension yourself in step 2
+below.
```text
Set up browser-skill on this machine by following https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md
@@ -67,10 +70,9 @@ Set up browser-skill on this machine by following https://raw.githubusercontent.
-Install the CLI, then install the extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi)
-or [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg).
+Install the CLI and skill with the commands below.
-#### 1. Install the `bsk` CLI
+#### Install the `bsk` CLI
**macOS / Linux** (recommended — installs to `~/.local/bin`):
@@ -90,18 +92,7 @@ Verify the binary:
bsk --version
```
-#### 2. Install the browser extension
-
-Install BrowserSkill from your browser's store:
-
-| Browser | Store listing |
-| --- | --- |
-| Chrome | [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) |
-| Microsoft Edge | [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) |
-
-On other Chromium-based browsers, install the Chrome Web Store build.
-
-#### 3. Install the skill
+#### Install the skill
BrowserSkill ships a skill that teaches your agent harness how to use `bsk`. For
these harnesses, install it in one step:
@@ -136,6 +127,21 @@ dedicated plugin instead — see [DeepSeek Harness plugin](#deepseek-harness-plu
+### 2. Install the browser extension
+
+Due to current browser security policies, you still need to manually install
+the extension for your browser.
+Open the store link for your browser and confirm the extension installation:
+
+| Browser | Store listing |
+| --- | --- |
+| Chrome | [Chrome Web Store](https://chromewebstore.google.com/detail/browserskill/hhcmgoofomhgciiibhipgmgkgnoenaoi) |
+| Microsoft Edge | [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) |
+
+On other Chromium-based browsers, install the Chrome Web Store build.
+
+### 3. Start using BrowserSkill
+
Start a new Agent session and write a prompt that needs the browser, for example:
```text
diff --git a/README.zh-CN.md b/README.zh-CN.md
index b0c8582..1e9d1f8 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -36,12 +36,14 @@ BrowserSkill 由两个本地运行组件组成：`bsk` CLI/daemon 和浏览器
## 快速开始
+### 1. 安装 CLI 和 skill
+
让 Agent 帮你安装（推荐）
-已经在用 Cursor、Claude Code、Codex 或其他支持 Shell 的 Agent？只需复制下面这句话发给 Agent，它会帮你安装 CLI 和 skill，并引导你加载浏览器扩展：
+已经在用 Cursor、Claude Code、Codex、WorkBuddy 或其他支持 Shell 的 Agent？只需复制下面这句话发给 Agent，它会帮你安装 CLI 和 skill。浏览器扩展仍需你按下方第 2 步自行安装。
```text
按照 https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md 的说明，在本机安装并配置 browser-skill
@@ -54,10 +56,9 @@ BrowserSkill 由两个本地运行组件组成：`bsk` CLI/daemon 和浏览器
-先安装 CLI，再从 [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi)
-或 [Edge 加载项商店](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) 安装浏览器扩展。
+按以下命令安装 CLI 和 skill。
-#### 1. 安装 `bsk` CLI
+#### 安装 `bsk` CLI
**macOS / Linux**（推荐，安装到 `~/.local/bin`）：
@@ -77,18 +78,7 @@ irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | ie
bsk --version
```
-#### 2. 安装浏览器扩展
-
-在对应浏览器的商店安装 BrowserSkill：
-
-| 浏览器 | 商店页面 |
-| --- | --- |
-| Chrome | [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) |
-| Microsoft Edge | [Edge 加载项商店](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) |
-
-其他基于 Chromium 的浏览器，安装 Chrome Web Store 版本即可。
-
-#### 3. 安装 skill
+#### 安装 skill
BrowserSkill 自带 skill，用于教 Agent harness 如何使用 `bsk`。以下 harness 可一键安装：
@@ -117,6 +107,20 @@ bsk install-skill
+### 2. 安装浏览器扩展
+
+目前由于浏览器的安全策略，您还需要手动安装对应的浏览器扩展。
+点击对应浏览器的商店链接，并在浏览器中确认安装扩展：
+
+| 浏览器 | 商店页面 |
+| --- | --- |
+| Chrome | [Chrome Web Store](https://chromewebstore.google.com/detail/browserskill/hhcmgoofomhgciiibhipgmgkgnoenaoi) |
+| Microsoft Edge | [Edge 加载项商店](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) |
+
+其他基于 Chromium 的浏览器，安装 Chrome Web Store 版本即可。
+
+### 3. 开始使用 BrowserSkill
+
启动一个新的 Agent 会话，写一条需要使用浏览器的 prompt，例如：
```text