feat: update readme

skills/pouch/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: pouch
 description: >-
-  创建、校验、转正、安装或发布 ~/.pouch 自研 skill，初始化 skill 项目状态，
-  或优化 skill 分层加载结构以减少 token 浪费。
-  触发词：pouch、skiff、自研 skill、创建 skill、publish skill、安装自研 skill、
-  初始化 skill、优化 skill 结构、减少 token 浪费、skill 太长、分层加载。
+  创建、校验、转正、安装或发布 ~/.pouch 自研 skill；代装 pouch、介绍 builtin
+  skill、在项目里接入并引导初始化；或优化 skill 分层结构以减少 token 浪费。
+  触发词：pouch、skiff、帮我装 pouch、有哪些 skill、skill 怎么用、接入当前项目、
+  初始化 skill、创建 skill、publish skill、优化 skill 结构、分层加载。
 ---
 
 # pouch 自研 Skill 工作流
@@ -15,24 +15,38 @@ SSOT 固定在 `~/.pouch/skills/<name>/`。内容通过 **symlink** 分发到各
 
 ## 选择模式
 
+- 安装 pouch、帮我装 pouch、代装、丢仓库 URL、`~/.pouch` 还不存在：读
+  [install.md](references/install.md) 并执行。
+- 有哪些 skill、skill 怎么用、介绍 skill：执行「介绍 builtin skill」。
+- 在这个项目接入、把 skill 接上、引导初始化：读
+  [onboard.md](references/onboard.md) 并执行。
 - 创建、完善、转正草稿：执行「创建新的 skill」。
 - 行为不对、触发不准、校验失败、可复用优化回流：执行「问题或优化回流」。
-- 优化结构、减少 token 浪费、skill 太长、分层加载：执行「优化 skill 结构」。先读
-  [token-structure.md](references/token-structure.md)。
+- 优化结构、减少 token 浪费、skill 太长、分层加载：执行「优化 skill 结构」。
 - 安装、卸载、浏览、init、status：执行「安装与维护」。
 
 ---
 
-## 在项目中使用 skill
+## 介绍 builtin skill
 
-先浏览可用的 builtin skill，再安装到当前项目：
+不要通读各 README，不要把 `pouch add --list` 的 description 念给用户。跑：
+
+```bash
+python3 <pouch-skill-dir>/scripts/catalog.py
+```
+
+把表格里的「做什么」和「可以这么说」原样告诉用户。用户点名再 `pouch add`。
+
+## 在项目中使用 skill
+
+已点名则直接安装；没点名或要按仓库判断：读 [onboard.md](references/onboard.md)。
 
 ```bash
-pouch add --list
 pouch add <name> -a cursor -a claude -a codex -a agents -y
 ```
 
-`pouch add <name>` 默认安装到当前项目；只有用户明确需要所有项目使用时才加 `-g`。安装结果是指向 `~/.pouch/skills/<name>/` 的软链，不要在 Agent 目录创建副本。
+默认当前项目；只有用户明确需要所有项目使用时才加 `-g`。只建指向
+`~/.pouch/skills/<name>/` 的软链，不要在 Agent 目录创建副本。
 
 ## 创建新的 skill
 
@@ -159,7 +173,7 @@ pouch remove discussion-notes -g -a cursor -y     # 全局
 pouch rm discussion-notes -g -y                     # rm 别名
 ```
 
-浏览可用自研 skill：
+浏览可用自研 skill（给 Agent 匹配用，不要念给用户）：
 
 ```bash
 pouch add --list