skills-cli

使用這個 skill 來幫助使用者透過 skills CLI 操作開放的 Agent Skills 生態系。

概述

skills CLI 是可安裝 Agent Skills 的套件管理器。用它來探索 skills、以正確的旗標安裝，以及管理已安裝的 skills。

以下範例使用 bunx skills，但如果使用者環境中沒有 Bun，npx skills 是相同的工作流程。

一律優先使用目前的 CLI 語法：

bunx skills add <source> --skill <name>

不要使用舊的 owner/repo@skill-name 範例。

使用時機

當使用者有以下情況時使用此 skill：

• 問「找一個做 X 的 skill」、「有沒有做 X 的 skill」或「我該怎麼做 X」，而 X 聽起來像可重複使用的工作流程
• 問「你可以做 X 嗎」，而 X 聽起來像某種可能已有對應 skill 的專門能力
• 需要 bunx skills、npx skills、skills.sh、skill 套件安裝或 skills-lock.json 的協助
• 想為特定 agent（如 Codex 或 OpenCode）安裝 skill
• 想列出、檢查、更新、移除、還原、同步、備份或初始化已安裝的 skills
• 想搜尋工作流程、工具、範本或特定領域的能力，例如設計、測試、部署、文件或程式碼審查

當使用者已經有本機 skill 並想協助撰寫或改善其內容時，請勿使用此 skill。在這種情況下，請改用 skill 撰寫工作流程。

探索工作流程

當使用者需要一個 skill 時，依以下順序進行：

1. 確定領域與任務。
   範例：React 效能、PR 審查、changelog 產生、PDF 擷取。
   同時判斷該任務是否常見，以至於很可能存在可重複使用的 skill。
2. 先檢查 skills.sh。
   當該領域已有知名且安裝量高的 skill 時，優先選擇。
3. 如果排行榜無法清楚回答需求，則使用以下指令搜尋：

bunx skills find <query>

4. 在推薦任何東西之前先驗證品質：
   • 安裝數：優先選擇安裝數 1K+ 的 skill，對低於 100 的 skill 要謹慎
   • 來源信譽：優先選擇官方或知名維護者，例如 openai、anthropics、microsoft 或同等可信的發行者
   • 儲存庫品質：檢查來源儲存庫，對星星數低於 100 的儲存庫中的 skill 持保留態度
5. 清楚呈現選項。
   包括 skill 名稱、用途、安裝數與來源、為何看起來可信、安裝指令，以及在 skills.sh 上進一步了解的連結。
6. 如果使用者想繼續，提供安裝協助。
7. 如果沒有符合的 skill，直接說明，使用你的通用能力協助該任務，並提到使用者可以用 bunx skills init 建立自己的套件。

安裝快速參考

常見來源

# GitHub 簡寫
bunx skills add xixu-me/skills

# 完整 GitHub URL
bunx skills add https://github.com/xixu-me/skills

# 儲存庫內單一 skill 的直接路徑
bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli

# GitLab URL
bunx skills add https://gitlab.com/org/repo

# 任何 git URL
bunx skills add git@github.com:owner/repo.git

# 本機套件路徑
bunx skills add ./my-local-skills

常見安裝模式

# 列出套件中的 skills 但不安裝
bunx skills add <source> --list

# 安裝一個 skill
bunx skills add <source> --skill skills-cli

# 安裝多個 skills
bunx skills add <source> --skill pr-review --skill commit

# 全域安裝
bunx skills add <source> --skill skills-cli -g -y

# 安裝到特定 agent
bunx skills add <source> --skill skills-cli -a codex -y

# 安裝所有 skills 到所有 agents
bunx skills add <source> --all

# 安裝所有 skills 到一個 agent
bunx skills add <source> --skill '*' -a codex -y

# 複製檔案而非建立符號連結
bunx skills add <source> --skill skills-cli -a codex --copy -y

安裝方式

當使用者選擇安裝方式時：

• 符號連結是預設值，通常是最佳選擇，因為更新會集中管理
• --copy 會建立獨立的副本，當符號連結不受支援或不方便時作為備案

如果使用者只要求安裝 skill，除非他們提到 CI 打包、可攜性、檔案系統限制或明確要求複製，否則優先使用預設的符號連結工作流程。

重要旗標

旗標	用途
--skill <name>	安裝一個或多個指定的 skills
-a, --agent <agent>	指定目標 agent，例如 codex
-g, --global	安裝在使用者範圍而非專案範圍
-y, --yes	跳過提示
--list	列出套件中可用的 skills
--copy	複製而非建立符號連結
--all	將所有 skills 安裝到所有 agents 的簡寫

管理已安裝的 Skills

使用以下指令進行日常維護：

# 列出已安裝的 skills
bunx skills ls
bunx skills ls -g
bunx skills ls -a codex
bunx skills ls --json

# 檢查更新
bunx skills check

# 更新已安裝的 skills
bunx skills update

# 移除已安裝的 skills
bunx skills remove my-skill
bunx skills remove my-skill -a codex
bunx skills remove -g my-skill
bunx skills remove --all

# 初始化新的 skill 套件
bunx skills init
bunx skills init my-skill

# 從 skills-lock.json 還原
bunx skills experimental_install

# 將 node_modules 中的 skills 同步到 agent 目錄
bunx skills experimental_sync
bunx skills experimental_sync -a codex -y

當使用者要求初始化 skill 時，說明他們想要的是：

• bunx skills init 在目前目錄建立 SKILL.md
• bunx skills init <name> 建立一個包含 SKILL.md 的新子目錄

相關工具：Skills Vault

如果使用者想要跨機器或團隊對已安裝的 skills 進行宣告式備份與還原，請使用 Skills Vault。

Skills Vault 是 skills 生態系的獨立 CLI 輔助工具。它不是 skills add 可安裝的 skill 來源。當使用者想要將已安裝的 skills 快照成 manifest、預覽還原指令，或在其他地方重現相同設定時使用。

常見的輔助指令：

# 將已安裝的 skills 備份到 skvlt.yaml
bunx skvlt backup

# 預覽還原
bunx skvlt restore --dry-run

# 從 manifest 還原所有內容
bunx skvlt restore --all

# 診斷本機環境
bunx skvlt doctor

當使用者明確想要可攜的 manifest 工作流程、跨機器備份與還原，或團隊共享已安裝的 skill 設定時，優先使用此工具而非 skills experimental_*。

推薦格式

推薦 skill 時，保持回答具體且可安裝。

使用類似以下的結構：

我找到一個應該符合需求的 skill。

Skill: <skill-name>
符合原因：<一句話>
來源：<owner/repo 或 URL>
品質檢查：<安裝數 / 來源信譽 / 儲存庫可信度備註>
安裝：
bunx skills add <source> --skill <skill-name> [選擇性旗標]
了解更多：https://skills.sh/<publisher>/<package>/<skill-name>

如果您願意，我可以為 <agent-or-scope> 安裝它。

如果使用者提到目標 agent 或範圍，請將其包含在指令中。範例：

bunx skills add <source> --skill <skill-name> -a codex -y
bunx skills add <source> --skill <skill-name> -g -y

範例：

我找到一個可能有幫助的 skill。

Skill: screenshot
符合原因：它專注於作業系統層級的桌面與視窗螢幕截圖。
來源：openai/skills
品質檢查：高安裝量、可信的發行者，且來源儲存庫廣泛使用。
安裝：
bunx skills add openai/skills --skill screenshot
了解更多：https://skills.sh/openai/skills/screenshot

常見 Skill 分類

當使用者的措辭模糊時，將其對應到可能的分類：

分類	範例查詢
網頁開發	react、nextjs、typescript、css、tailwind
測試	testing、jest、playwright、e2e
DevOps	deploy、docker、kubernetes、ci-cd
文件	docs、readme、changelog、api-docs
程式碼品質	review、lint、refactor、best-practices
設計	ui、ux、design-system、accessibility
生產力	workflow、automation、git

搜尋技巧

• 使用具體關鍵字。react testing 比單純 testing 更好。
• 嘗試替代詞。如果 deploy 沒結果，試試 deployment 或 ci-cd。
• 先檢查熱門來源。許多強大的 skill 來自知名發行者。
• 如果第一次搜尋太廣泛，用領域加上任務來縮小範圍。

常見錯誤

• 從搜尋結果推薦 skill 時，沒有檢查它是否看起來已建立信譽。
• 當使用者指定了特定 agent 時，忘記加上 -a <agent>。
• 將 bunx skills find --help 當作真正的說明指令。請改用 bunx skills --help 取得指令說明。
• 在一個弱搜尋詞後就假設沒有 skill 存在。先嘗試更具體或相關的查詢。

疑難排解

如果使用者遇到錯誤或令人困惑的結果：

• 「找不到 skills」- 建議更好的查詢，檢查 skills.sh，或直接協助並提到 bunx skills init
• 自動化或 CI 中的互動式提示 - 加上 -y
• 錯誤的安裝範圍 - 在專案安裝與 -g 之間切換
• 符號連結問題 - 改用 --copy 重試
• 不確定套件內容 - 執行 bunx skills add <source> --list
• 不確定已安裝狀態 - 執行 bunx skills ls 或 bunx skills ls --json
• 跨機器的可攜備份或還原 - 提及 Skills Vault 及其 backup / restore --dry-run 工作流程

當你不確定確切旗標時，請使用：

bunx skills --help