diff --git a/README.md b/README.md
index 4abc89d..d24e9b5 100644
--- a/README.md
+++ b/README.md
@@ -50,3 +50,22 @@ claude plugin marketplace remove jsc-marketplace
 ## 授權
 
 [MIT License](LICENSE)
+
+## 移除舊的技能
+
+技能已統一收進 `jsc-skills`，舊的安裝方式請移除，以免同名技能重複：
+
+```bash
+# 舊的獨立 herdr-issue plugin（改用 /jsc-skills:herdr-issue）
+claude plugin uninstall herdr-issue@jsc-marketplace
+
+# 若曾自行加入上游 herdr-issue 的 marketplace
+claude plugin uninstall herdr-issue@herdr-issue
+claude plugin marketplace remove herdr-issue
+
+# 若曾手動複製到本機技能目錄
+rm -rf ~/.claude/skills/herdr-issue ~/.claude/skills/herdr
+rm -rf ~/.agents/skills/herdr ~/.agents/skills/herdr-issue
+```
+
+`ingest` 原本隨 `companion` 提供，更新 `companion` 後即不再包含，請改用 `/jsc-skills:ingest`。