diff --git a/AGENTS.md b/AGENTS.md
index 4681065..ee51778 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -75,5 +75,6 @@
 ## 7. 版本与扩展
 
 - Skill 名：`gwin-skill`（仓库名同）  
+- **远程仓库**：https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git  
 - 新外设：只追加 `reference-pins.md` 表格 + `examples.md` 一节  
 - 新器件：新建 `reference-<board>.md`，并在 `SKILL.md` 环境表增加一行  
diff --git a/README.md b/README.md
index 75be87a..59f59b3 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 高云（Gowin）ACG525 / GW5A-25A 开发板 **全流程工具链 Skill 仓库**：设计规范、工程组织、CLI 综合、下载，以及如何让 Cursor Agent 按同一套流程操作。
 
+**远程仓库：** https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git
+
 ## 谁该用
 
 | 角色 | 入口 |
diff --git a/SKILL.md b/SKILL.md
index 33a2a5f..affef47 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -2,13 +2,22 @@
 name: gwin-skill
 description: >-
   Gowin (高云) ACG525 / GW5A-25A FPGA full toolchain: project layout, Verilog/CST/SDC
-  design rules, gw_sh build, programmer_cli download, TFT RGB pin map. Use when the
-  user mentions 高云, Gowin, GW5A, ACG525, .gprj, gw_sh, Programmer, TFT/LCD 刷屏,
-  FPGA 综合下载, or asks an agent to build/flash Gowin board projects.
+  design rules, gw_sh build, programmer_cli download, TFT RGB pin map. Canonical repo:
+  https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git . Use when the user mentions
+  高云, Gowin, GW5A, ACG525, .gprj, gw_sh, Programmer, TFT/LCD 刷屏, FPGA 综合下载,
+  or asks an agent to build/flash Gowin board projects.
 ---
 
 # Gwin Skill — 高云 FPGA 全流程
 
+## 仓库地址
+
+- **Git（权威源）**：https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git
+- **浏览 / Clone**：https://git.whcself.xyz/FPGA-IQBoost/gwin-skill
+- **本地路径**：`Documents/fpga/gwin-skill`（可 junction 到 `~/.cursor/skills/gwin-skill`）
+
+Agent 拉取或核对版本时以该远程仓库为准；本地若落后先 `git pull`。
+
 **立即阅读本文件后按流程执行。** 细节按需打开同目录参考文档，不要凭记忆猜引脚或命令。
 
 ## Agent 必做清单