用 npx skills 分享自己的 AI Skills

最近整理了一個小工具：code-review-handoff-and-fix。 這個工具的目的很單純，讓一個 AI agent 先做 code review，把 findings 存成檔案； 接著再讓另一個 AI agent 讀取這份 review file，並依照內容套用修正。 Repository 在這裡：https://github.com/ddsakura/code-review-handoff-and-fix。

我原本只是想把自己的 AI workflow 整理得更一致一些， 沒想到過程中發現， 原來只要遵循標準 Skills 結構， 就可以直接透過 npx skills add 讓其他人安裝使用。

如果你有自己寫的 Claude Code Skill、Codex Skill，甚至是團隊內部常用的 Agent Workflow，其實都可以用這種方式分享出去。

這個專案原本的結構如下：

 claude/
   commands/
     rh.md
     rf.md

 codex/
   skills/
     rf/
       SKILL.md

也就是 Claude Code 透過 commands， Codex 透過 skill， 來達成相互 Code review 的需求。

這樣雖然可以運作， 但缺點是相同的 workflow 需要維護兩份不同格式的定義。

後來我發現 Vercel 的 skills (https://github.com/vercel-labs/skills) package 提供了一個更通用的方式。

只要 repository 裡的 skill 遵循標準結構，就可以透過：

 npx skills add owner/repo

直接被發現並安裝。

所以我把原本專案的結構調整如下：

 skills/
   rh/
     SKILL.md
   rf/
     SKILL.md

每個 skill 都是一個資料夾， 裡面有 SKILL.md，並且包含必要的屬性，例如：

 name: rf
 description: >
 Read the latest AI review file from .ai-reviews/latest.md and apply all the
 fixes

這樣一來，整個 repository 的結構就簡單許多。 不需要再分：

 claude/commands/
 codex/skills/

而是讓 skills/ 成為 single source of truth。

安裝方式也很單純 project-based 安裝：

npx skills add ddsakura/code-review-handoff-and-fix

只安裝某個 skill：

npx skills add ddsakura/code-review-handoff-and-fix --skill rf

指定 agent：

npx skills add ddsakura/code-review-handoff-and-fix --agent codex
npx skills add ddsakura/code-review-handoff-and-fix --agent claude-code

global 安裝：

npx skills add ddsakura/code-review-handoff-and-fix --global

開發過程中，也不一定要先 push 到 GitHub。 可以用以下指令，直接驗證：

npx skills add . — list

這會列出目前 repo 裡可被發現的 skills， 很適合在調整 repo 結構時快速確認。

整理過程中，我也順手重新理解了一次 Command 與 Skill 的差異。 Command 比較像是使用者明確輸入的指令，Claude 收到什麼就執行什麼。

Skill 比較像是任務專用的操作手冊， Agent 會根據任務類型自動判斷是否需要參考對應的 skill 文件， 並依照 Skill 裡定義的流程執行。

兩者的關鍵差異在於觸發方式： Command 只能由使用者手動叫用； Skill 除了可以手動叫用，也可以讓 Agent 根據情境自動觸發。

目前 command 雖然仍可繼續使用， 但 Claude 官方推薦改用 skill 格式。

總而言之， 只要 skills 的架構是標準結構， 就可以透過 Vercel 的 skills 套件分享給需要的人使用。

雖然只是個小發現， 但還是分享給跟我一樣比較晚注意到， 或剛好正在整理 AI Agent Workflow 的朋友。