diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index a35fb4d..06a4b91 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -33,6 +33,13 @@
       "skills": [
         "./skills/why-here"
       ]
+    },
+    {
+      "name": "workspace-setup",
+      "description": "Scaffold a personal execution workspace: directories, code-workspace file, AGENTS.md and optional CODINGRULES.md.",
+      "skills": [
+        "./skills/init-workspace"
+      ]
     }
   ]
 }
diff --git a/.dist-sync/sources.json b/.dist-sync/sources.json
index 29654fb..6389c93 100644
--- a/.dist-sync/sources.json
+++ b/.dist-sync/sources.json
@@ -29,6 +29,11 @@
       "name": "why-here",
       "repository": "agent-skills/why-here",
       "asset": "why-here.zip"
+    },
+    {
+      "name": "init-workspace",
+      "repository": "agent-skills/init-workspace",
+      "asset": "init-workspace.zip"
     }
   ]
 }
diff --git a/.gitea/workflows/sync-releases.yml b/.gitea/workflows/sync-releases.yml
index 9c53701..bae3d16 100644
--- a/.gitea/workflows/sync-releases.yml
+++ b/.gitea/workflows/sync-releases.yml
@@ -50,6 +50,7 @@ jobs:
               "baimiao-table-ocr",
               "disk-master",
               "everything-file-search",
+              "init-workspace",
               "teach-me",
               "think-twice",
               "why-here",
diff --git a/README.md b/README.md
index 1d903c8..c3b020b 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,14 @@ npx skills update
 > [!WARNING]
 > 图片会上传到白描的第三方服务进行识别。不要用它处理隐私敏感或不能离开本机的图片。
 
+### 工作区初始化
+
+#### [`init-workspace`](./skills/init-workspace/SKILL.md)
+
+为个人执行工作区搭脚手架：创建目录骨架和 `.claude/skills` Junction，生成 `<project>.code-workspace`、`AGENTS.md` 与可选的 `CODINGRULES.md`。工作区模式是一个目录同时容纳源码仓库、本地文档库和参考库。
+
+它只在你明确要求初始化或重构工作区时触发。已有文件不会被覆盖，改动会先逐节给出提案，确认后才写入。
+
 ## 常见用法
 
 你可以直接对 agent 说：
@@ -89,4 +97,6 @@ npx skills update
 - “分析一下 `C:` 盘为什么满了，只做只读扫描，并生成 HTML 报告。”
 - “帮我找出这台 Windows 电脑上所有叫 `settings.json` 的文件。”
 - “把这张表格截图转成 Markdown 表格。”
+- “在 `E:\Projects\foo` 用 `init-workspace` 建一个工作区，源码仓是这个地址。”
+oo` 用 `init-workspace` 建一个工作区，源码仓是这个地址。”
 - “这次改动中途换过方案，提交前用 `why-here` 看看还有没有只属于旧方案的内容。”