技能教程 · 代理
註冊表裝法，和它該長成的樣子
npx skills 把一行安裝帶火了：從註冊表或 repo 拉一個技能目錄，鋪進你在用的每個代理。WorkshopSkill 的包發布的正是同一單元——一個具名目錄，裡躺著一份 SKILL.md——兩邊天生咬合。
安裝器實際做的是什麼
解析技能名，把目錄複製進它認識的所有代理技能路徑（~/.claude/skills、~/.codex/skills……），記下裝了什麼在哪。概念上就是技能界的包管理器。注意：它不轉換技能——所以凡依慣例發布的目錄都能被它搬。
本站對安裝器的承諾
安裝器要複製的那個單元
blind-portrait/ SKILL.md # name + description + metadata + 指令 manifest.json # 版本、更新時間、逐檔 sha256 ...可列印檔 # 都被 SKILL.md 按名稱引用 不用安裝器的一條指令： curl -LO https://workshopskill.com/zh-hant/activities/blind-portrait/files/blind-portrait.zip unzip blind-portrait.zip
給團隊自建註冊表
想要 npx skills add my-org/blind-portrait 這種裝法：把包鏡像進一個 GitHub repo（每技能一個目錄，正是註冊表讀的形狀），讓安裝器指向它。本站 skills.json 帶著名字、描述、包網址與校驗和——註冊表播種需要的全在這。
什麼時候別用註冊表
- 只為一場課取三個檔案：curl 比工具鏈快——沒有 npm 快取，不要求 Node。
- 斷網會場：zip 就是離線交付物；註冊表多一跳網路。
- 要稽核：包內 manifest 逐檔雜湊值能位元組級複核；註冊表交付的是「它當天發的那份」。
接著讀
常見問題
本站進了公開註冊表嗎？
本站自己就是註冊表：skills.json 加每技能一個 zip。第三方註冊表可以收錄它；curl 是欽定的安裝路徑。
註冊表裝的技能會自動更新嗎？
這個家族裡沒人自動更新——誠實的答案。用 metadata.updated 對 skills.json，或比對 manifest.json 的逐檔 sha256。
哪些代理被 npx skills 支援？
帶技能目錄的主流載入器（Claude Code、Codex 一系）；本站每篇代理教程都寫明了確切路徑。