From ceb5f65d3fa61b9e858adf79fe80d073636d29f4 Mon Sep 17 00:00:00 2001 From: wizardchen Date: Wed, 9 Sep 2026 18:03:12 +0800 Subject: [PATCH 1/2] docs(skill): add bsk installation and readiness checks --- crates/bsk-cli/skill/SKILL.md | 41 +++++++++++++++++++++++++++++++++++ skill/SKILL.md | 41 +++++++++++++++++++++++++++++++++++ 2 files changed, 82 insertions(+) diff --git a/crates/bsk-cli/skill/SKILL.md b/crates/bsk-cli/skill/SKILL.md index f27ab2f7..14d9f304 100644 --- a/crates/bsk-cli/skill/SKILL.md +++ b/crates/bsk-cli/skill/SKILL.md @@ -16,6 +16,47 @@ are explicitly borrowed. Do not use this skill for tasks with no browser, for extension installation, or when the user only wants instructions. Never extract credentials, cookies, tokens, or other secrets from pages. +## Prerequisites and first-time setup + +The `bsk` CLI and BrowserSkill extension must run on the machine with the user's browser. +Installing this skill alone does not install either runtime component. + +Check `bsk --version` before the first browser task. If the CLI is missing, use the official +installer for the current platform; skip installation when `bsk` is already available. + +**macOS / Linux (sh, bash, or zsh):** + +```sh +curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh +export PATH="$HOME/.local/bin:$PATH" +bsk --version +``` + +**Windows (PowerShell):** + +```powershell +irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex +bsk --version +``` + +The default install directory is `~/.local/bin`; no administrator privileges are needed. +If the command is still unavailable, check that directory and the current process's `PATH` before +reinstalling. Restart the terminal or agent if it inherited an older `PATH`. + +Run `bsk doctor` before starting the first session. If no extension is connected, ask the user to +install or enable BrowserSkill in the browser profile they want to automate: + +- [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) +- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) + +Have the user open the extension popup and wait for its green connected state, then rerun +`bsk doctor`. Proceed when every check is `ok` or `na`; otherwise follow the failing check's hint. +Extension installation is a manual prerequisite, not a browser automation step. + +See the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) +for setup troubleshooting and [Quick Start](https://github.com/Tencent/BrowserSkill#quick-start) +for installing the skill into another agent harness. + ## Required lifecycle Every browser task owns a bounded session: diff --git a/skill/SKILL.md b/skill/SKILL.md index f27ab2f7..14d9f304 100644 --- a/skill/SKILL.md +++ b/skill/SKILL.md @@ -16,6 +16,47 @@ are explicitly borrowed. Do not use this skill for tasks with no browser, for extension installation, or when the user only wants instructions. Never extract credentials, cookies, tokens, or other secrets from pages. +## Prerequisites and first-time setup + +The `bsk` CLI and BrowserSkill extension must run on the machine with the user's browser. +Installing this skill alone does not install either runtime component. + +Check `bsk --version` before the first browser task. If the CLI is missing, use the official +installer for the current platform; skip installation when `bsk` is already available. + +**macOS / Linux (sh, bash, or zsh):** + +```sh +curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh +export PATH="$HOME/.local/bin:$PATH" +bsk --version +``` + +**Windows (PowerShell):** + +```powershell +irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex +bsk --version +``` + +The default install directory is `~/.local/bin`; no administrator privileges are needed. +If the command is still unavailable, check that directory and the current process's `PATH` before +reinstalling. Restart the terminal or agent if it inherited an older `PATH`. + +Run `bsk doctor` before starting the first session. If no extension is connected, ask the user to +install or enable BrowserSkill in the browser profile they want to automate: + +- [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) +- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) + +Have the user open the extension popup and wait for its green connected state, then rerun +`bsk doctor`. Proceed when every check is `ok` or `na`; otherwise follow the failing check's hint. +Extension installation is a manual prerequisite, not a browser automation step. + +See the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) +for setup troubleshooting and [Quick Start](https://github.com/Tencent/BrowserSkill#quick-start) +for installing the skill into another agent harness. + ## Required lifecycle Every browser task owns a bounded session: From da0d038112523250add47227a03ab3244cd3b687 Mon Sep 17 00:00:00 2001 From: wizardchen Date: Wed, 9 Sep 2026 18:14:06 +0800 Subject: [PATCH 2/2] docs(skill): simplify prerequisite guidance --- crates/bsk-cli/skill/SKILL.md | 45 ++++++----------------------------- skill/SKILL.md | 45 ++++++----------------------------- 2 files changed, 14 insertions(+), 76 deletions(-) diff --git a/crates/bsk-cli/skill/SKILL.md b/crates/bsk-cli/skill/SKILL.md index 14d9f304..1f2df92a 100644 --- a/crates/bsk-cli/skill/SKILL.md +++ b/crates/bsk-cli/skill/SKILL.md @@ -16,46 +16,15 @@ are explicitly borrowed. Do not use this skill for tasks with no browser, for extension installation, or when the user only wants instructions. Never extract credentials, cookies, tokens, or other secrets from pages. -## Prerequisites and first-time setup +## Prerequisites -The `bsk` CLI and BrowserSkill extension must run on the machine with the user's browser. -Installing this skill alone does not install either runtime component. +Installing this skill alone does not install the `bsk` CLI or browser extension. +If `bsk` is not found, check `PATH` (the default install directory is `~/.local/bin`), then +use the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) +if setup is needed. Verify CLI availability with `bsk --version`. -Check `bsk --version` before the first browser task. If the CLI is missing, use the official -installer for the current platform; skip installation when `bsk` is already available. - -**macOS / Linux (sh, bash, or zsh):** - -```sh -curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh -export PATH="$HOME/.local/bin:$PATH" -bsk --version -``` - -**Windows (PowerShell):** - -```powershell -irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex -bsk --version -``` - -The default install directory is `~/.local/bin`; no administrator privileges are needed. -If the command is still unavailable, check that directory and the current process's `PATH` before -reinstalling. Restart the terminal or agent if it inherited an older `PATH`. - -Run `bsk doctor` before starting the first session. If no extension is connected, ask the user to -install or enable BrowserSkill in the browser profile they want to automate: - -- [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) -- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) - -Have the user open the extension popup and wait for its green connected state, then rerun -`bsk doctor`. Proceed when every check is `ok` or `na`; otherwise follow the failing check's hint. -Extension installation is a manual prerequisite, not a browser automation step. - -See the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) -for setup troubleshooting and [Quick Start](https://github.com/Tencent/BrowserSkill#quick-start) -for installing the skill into another agent harness. +If the extension is not connected, direct the user to the same guide to install or enable it +in their browser, then run `bsk doctor` to verify readiness before starting a session. ## Required lifecycle diff --git a/skill/SKILL.md b/skill/SKILL.md index 14d9f304..1f2df92a 100644 --- a/skill/SKILL.md +++ b/skill/SKILL.md @@ -16,46 +16,15 @@ are explicitly borrowed. Do not use this skill for tasks with no browser, for extension installation, or when the user only wants instructions. Never extract credentials, cookies, tokens, or other secrets from pages. -## Prerequisites and first-time setup +## Prerequisites -The `bsk` CLI and BrowserSkill extension must run on the machine with the user's browser. -Installing this skill alone does not install either runtime component. +Installing this skill alone does not install the `bsk` CLI or browser extension. +If `bsk` is not found, check `PATH` (the default install directory is `~/.local/bin`), then +use the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) +if setup is needed. Verify CLI availability with `bsk --version`. -Check `bsk --version` before the first browser task. If the CLI is missing, use the official -installer for the current platform; skip installation when `bsk` is already available. - -**macOS / Linux (sh, bash, or zsh):** - -```sh -curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh -export PATH="$HOME/.local/bin:$PATH" -bsk --version -``` - -**Windows (PowerShell):** - -```powershell -irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex -bsk --version -``` - -The default install directory is `~/.local/bin`; no administrator privileges are needed. -If the command is still unavailable, check that directory and the current process's `PATH` before -reinstalling. Restart the terminal or agent if it inherited an older `PATH`. - -Run `bsk doctor` before starting the first session. If no extension is connected, ask the user to -install or enable BrowserSkill in the browser profile they want to automate: - -- [Chrome Web Store](https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi) -- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/browserskill/emacgiaaaiojkkpkddmmdfhmokgmnikg) - -Have the user open the extension popup and wait for its green connected state, then rerun -`bsk doctor`. Proceed when every check is `ok` or `na`; otherwise follow the failing check's hint. -Extension installation is a manual prerequisite, not a browser automation step. - -See the official [installation guide](https://github.com/Tencent/BrowserSkill/blob/main/AGENT_INSTALL.md) -for setup troubleshooting and [Quick Start](https://github.com/Tencent/BrowserSkill#quick-start) -for installing the skill into another agent harness. +If the extension is not connected, direct the user to the same guide to install or enable it +in their browser, then run `bsk doctor` to verify readiness before starting a session. ## Required lifecycle