diff --git a/README.md b/README.md
index b7d220b4..7349e396 100644
--- a/README.md
+++ b/README.md
@@ -160,9 +160,9 @@ Layer 3: docs/             (权威静态文档)
 
 - 可做：增加新流程、从零教授新语言、添加跨语言通用知识
 
-## SKILLS（Codex CLI）
+## SKILLS（Codex CLI / Claude Code）
 
-本仓库内置一组 Codex CLI skills（见 `codex/skills/`），用于按需加载的工作流与知识库。
+本仓库内置一组 AI agent skills（见 `codex/skills/`），支持 Codex CLI 和 Claude Code，用于按需加载的工作流与知识库。
 
 TSL 相关问题直接查阅 `rulesets/tsl/index.md` 与 `docs/tsl/`。
 
diff --git a/playbook.toml.example b/playbook.toml.example
index 495f6f58..e1c7f00e 100644
--- a/playbook.toml.example
+++ b/playbook.toml.example
@@ -40,7 +40,7 @@
 [install_skills]
 # mode = "list"                 # list|all
 # skills = ["brainstorming"]    # mode=list 时必填
-# agents_home = "~/.agents"     # 可选：默认 ~/.agents
+# agents_home = "~/.agents"     # Codex CLI；Claude Code 用 "~/.claude"；默认 ~/.agents
 # no_backup = false             # 可选：跳过备份，直接删除旧 skill 后重装
 
 [format_md]