From 868822e2ed01f1ee35df7af764da6d492fe130c6 Mon Sep 17 00:00:00 2001
From: Panniantong <panniantong@users.noreply.github.com>
Date: Wed, 25 Feb 2026 04:35:35 +0100
Subject: [PATCH] =?UTF-8?q?fix:=20Skill=20=E5=8A=A0=20Setup=20=E5=BC=95?=
 =?UTF-8?q?=E5=AF=BC=EF=BC=8C=E7=BA=AF=20Skill=20=E5=AE=89=E8=A3=85?=
 =?UTF-8?q?=E4=B9=9F=E8=83=BD=E8=87=AA=E5=8A=A8=E8=A7=A6=E5=8F=91=20pip=20?=
 =?UTF-8?q?install?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

SKILL.md 增加 Setup 段：Agent 读到 skill 后先检测 agent-reach CLI
是否存在，不存在则自动 pip install + agent-reach install。
README 说明同步更新。
---
 README.md                  |  2 +-
 agent-reach/SKILL.md       | 18 ++++++++++++++++++
 agent_reach/skill/SKILL.md | 18 ++++++++++++++++++
 docs/README_en.md          |  2 +-
 4 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2c4d832..11e776b 100644
--- a/README.md
+++ b/README.md
@@ -105,7 +105,7 @@ agent-reach install --env=auto
 npx skills add Panniantong/Agent-Reach@agent-reach
 ```
 
-安装后，Agent 会在 Skill 列表中看到 `agent-reach`，自动知道如何使用所有搜索和阅读能力。
+Skill 安装后，Agent 读取 SKILL.md 时会自动检测 `agent-reach` CLI 是否存在，不存在则引导安装。
 
 > 如果通过 `agent-reach install` 安装，Skill 会自动注册，无需额外操作。
 </details>
diff --git a/agent-reach/SKILL.md b/agent-reach/SKILL.md
index 555d6bf..bb224fc 100644
--- a/agent-reach/SKILL.md
+++ b/agent-reach/SKILL.md
@@ -14,6 +14,24 @@ description: >
 
 Read and search the internet across 9+ platforms via unified CLI.
 
+## Setup
+
+First check if agent-reach is installed:
+```bash
+agent-reach doctor
+```
+
+If command not found, install it:
+```bash
+pip install https://github.com/Panniantong/agent-reach/archive/main.zip
+agent-reach install --env=auto
+```
+
+`install` auto-detects your environment and installs all dependencies (Node.js, mcporter, bird CLI, gh CLI). Read the output and run `agent-reach doctor` to see what's active.
+
+For channels that need user input, ask the user. See the full setup guide:
+https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
+
 ## Commands
 
 ### Read any URL
diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.md
index 555d6bf..bb224fc 100644
--- a/agent_reach/skill/SKILL.md
+++ b/agent_reach/skill/SKILL.md
@@ -14,6 +14,24 @@ description: >
 
 Read and search the internet across 9+ platforms via unified CLI.
 
+## Setup
+
+First check if agent-reach is installed:
+```bash
+agent-reach doctor
+```
+
+If command not found, install it:
+```bash
+pip install https://github.com/Panniantong/agent-reach/archive/main.zip
+agent-reach install --env=auto
+```
+
+`install` auto-detects your environment and installs all dependencies (Node.js, mcporter, bird CLI, gh CLI). Read the output and run `agent-reach doctor` to see what's active.
+
+For channels that need user input, ask the user. See the full setup guide:
+https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
+
 ## Commands
 
 ### Read any URL
diff --git a/docs/README_en.md b/docs/README_en.md
index ea609d7..cead304 100644
--- a/docs/README_en.md
+++ b/docs/README_en.md
@@ -95,7 +95,7 @@ agent-reach install --env=auto
 npx skills add Panniantong/Agent-Reach@agent-reach
 ```
 
-Once installed, your Agent will see `agent-reach` in its skill list and automatically know how to use all search and read capabilities.
+After the Skill is installed, the Agent will auto-detect whether `agent-reach` CLI is available and install it if needed.
 
 > If you install via `agent-reach install`, the skill is registered automatically — no extra steps needed.
 </details>