diff --git a/README.md b/README.md
index 65916b3..93ad468 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 | 内容 | 位置 | 说明 |
 |---|---|---|
 | **CLI**（命令 `inkreach-teable`） | 仓库根（`src/`，包即仓库） | 表、字段、记录、视图、自动化（8 触发器 + 7 动作）、密钥、执行历史、插件、订阅等全部 REST API 封装 |
-| **Agent Skill** | `.agents/skills/inkreach-teable/` | ZCode/Claude 技能：模块地图、路由规则、API 参考、实例运维指南 |
+| **Agent Skill** | `skills/inkreach-teable/` | ZCode 技能：模块地图、路由规则、API 参考、实例运维指南（安装到 `~/.zcode/skills/` 用户级后生效） |
 
 设计文档见 [`docs/cli-skill-design.md`](docs/cli-skill-design.md)。
 
@@ -18,7 +18,7 @@
 ```bash
 git clone ssh://git@gitea.inkreach.cc:2222/inkreachhub/inkreach-teable-cli.git
 cd inkreach-teable-cli
-bash .agents/skills/inkreach-teable/scripts/install.sh
+bash skills/inkreach-teable/scripts/install.sh
 ```
 
 安装脚本会：构建 CLI → 全局链接 `inkreach-teable` 命令 → 把 skill 安装到
@@ -45,6 +45,6 @@ pnpm typecheck
 ## 来源
 
 2026-09-23 从 inkreach-teable monorepo 拆分独立（原路径 `packages/inkreach-cli/` +
-`.agents/skills/inkreach-teable/`），git 历史完整保留。应用本体的开发/部署文档见
-skill 内 [development.md](.agents/skills/inkreach-teable/guides/development.md)（描述的是
+`.agents/skills/inkreach-teable/`，后者在本仓库移至 `skills/inkreach-teable/`），git 历史完整保留。应用本体的开发/部署文档见
+skill 内 [development.md](skills/inkreach-teable/guides/development.md)（描述的是
 inkreach-teable 应用仓库，不是本仓库）。
diff --git a/.agents/skills/inkreach-teable/SKILL.md b/skills/inkreach-teable/SKILL.md
similarity index 100%
rename from .agents/skills/inkreach-teable/SKILL.md
rename to skills/inkreach-teable/SKILL.md
diff --git a/.agents/skills/inkreach-teable/api-reference/action-types.md b/skills/inkreach-teable/api-reference/action-types.md
similarity index 100%
rename from .agents/skills/inkreach-teable/api-reference/action-types.md
rename to skills/inkreach-teable/api-reference/action-types.md
diff --git a/.agents/skills/inkreach-teable/api-reference/field-types.md b/skills/inkreach-teable/api-reference/field-types.md
similarity index 100%
rename from .agents/skills/inkreach-teable/api-reference/field-types.md
rename to skills/inkreach-teable/api-reference/field-types.md
diff --git a/.agents/skills/inkreach-teable/api-reference/trigger-types.md b/skills/inkreach-teable/api-reference/trigger-types.md
similarity index 100%
rename from .agents/skills/inkreach-teable/api-reference/trigger-types.md
rename to skills/inkreach-teable/api-reference/trigger-types.md
diff --git a/.agents/skills/inkreach-teable/evals/evals.json b/skills/inkreach-teable/evals/evals.json
similarity index 100%
rename from .agents/skills/inkreach-teable/evals/evals.json
rename to skills/inkreach-teable/evals/evals.json
diff --git a/.agents/skills/inkreach-teable/guides/automation-guide.md b/skills/inkreach-teable/guides/automation-guide.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/automation-guide.md
rename to skills/inkreach-teable/guides/automation-guide.md
diff --git a/.agents/skills/inkreach-teable/guides/cli-reference.md b/skills/inkreach-teable/guides/cli-reference.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/cli-reference.md
rename to skills/inkreach-teable/guides/cli-reference.md
diff --git a/.agents/skills/inkreach-teable/guides/development.md b/skills/inkreach-teable/guides/development.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/development.md
rename to skills/inkreach-teable/guides/development.md
diff --git a/.agents/skills/inkreach-teable/guides/instance-access.md b/skills/inkreach-teable/guides/instance-access.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/instance-access.md
rename to skills/inkreach-teable/guides/instance-access.md
diff --git a/.agents/skills/inkreach-teable/guides/subscription.md b/skills/inkreach-teable/guides/subscription.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/subscription.md
rename to skills/inkreach-teable/guides/subscription.md
diff --git a/.agents/skills/inkreach-teable/guides/tables-fields.md b/skills/inkreach-teable/guides/tables-fields.md
similarity index 100%
rename from .agents/skills/inkreach-teable/guides/tables-fields.md
rename to skills/inkreach-teable/guides/tables-fields.md
diff --git a/.agents/skills/inkreach-teable/metadata.json b/skills/inkreach-teable/metadata.json
similarity index 100%
rename from .agents/skills/inkreach-teable/metadata.json
rename to skills/inkreach-teable/metadata.json
diff --git a/.agents/skills/inkreach-teable/scripts/install.sh b/skills/inkreach-teable/scripts/install.sh
similarity index 94%
rename from .agents/skills/inkreach-teable/scripts/install.sh
rename to skills/inkreach-teable/scripts/install.sh
index 117c9af..f07eb08 100644
--- a/.agents/skills/inkreach-teable/scripts/install.sh
+++ b/skills/inkreach-teable/scripts/install.sh
@@ -10,9 +10,9 @@
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# Resolve the repo root: skill lives at <root>/.agents/skills/inkreach-teable/scripts/
-REPO_ROOT="$(cd "$SCRIPT_DIR/../../../.." && pwd)"
-SKILL_DIR="$REPO_ROOT/.agents/skills/inkreach-teable"
+# Resolve the repo root: skill lives at <root>/skills/inkreach-teable/scripts/
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+SKILL_DIR="$REPO_ROOT/skills/inkreach-teable"
 
 echo "=== inkreach-teable CLI installation ==="