這篇教學的每一條指令都來自本站在 RTX A6000 48 GB 工作站 上實際錄下的終端機過程（2026-10-29 的版本，commit 92a9a34ac3bf），照順序做即可。
開始前
本教學基於 Ubuntu 24.04 LTS 環境，需安裝 Node.js v22.23.4 或更高版本。雖然專案本身為 TypeScript CLI 工具，不直接依賴 GPU 運算，但建議在具備足夠記憶體（約 62 GB 可用）的工作站上執行以確保流暢體驗。請確保已安裝 npm 套件管理器，並準備好網路連線以存取 GitHub 與 skills.sh 註冊表。
安裝與執行
步驟 1：取得原始碼
從 GitHub 複製 vercel-labs/skills 專案並切換至指定 commit，確保使用測試過的穩定版本。
git clone https://github.com/vercel-labs/skills skills cd skills
成功時會看到：終端機顯示 git log 訊息 '92a9a34 2026-10-29 fix(install)...' 以及目錄大小 '2.3M'。（這一步我們花了 2.5 秒，結束碼 0）
toring from the lock (#2603) 2.3M . AGENTS.md LICENSE scripts ThirdPartyNoticeText.txt bin package.json skills tsconfig.json build.config.mjs pnpm-lock.yaml src docs README.md tests
步驟 2：全域安裝 CLI
透過 npm 全域安裝 skills 指令，使其可在終端機任何位置直接呼叫。
npm install -g --prefix "~/lab/npm" skills
成功時會看到：出現 'added 8 packages in 2s' 以及 funding 提示訊息。（這一步我們花了 1.7 秒，結束碼 0）
⠙⠹⠸⠼⠴⠦⠧⠇⠏⠋⠙⠹⠸⠼⠴⠦⠧ added 8 packages in 2s ⠇ ⠇1 package is looking for funding ⠇ run `npm fund` for details ⠇
步驟 3：初始化技能模板
建立一個名為 demo-skill 的範例技能，用於測試 CLI 的初始化功能與檔案結構。
skills init demo-skill
成功時會看到：畫面出現 ASCII Art 的 'SKILLS' 標誌，並顯示 'Initialized skill: demo-skill' 及建立檔案路徑。（這一步我們花了 0.1 秒，結束碼 0）
1. Edit demo-skill/SKILL.md to define your skill instructions 2. Update the name and description in the frontmatter Publishing: GitHub: Push to a repo, then npx skills add <owner>/<repo> URL: Host the file, then npx skills add https://example.com/demo-skill/SKILL.md Browse existing skills for inspiration at https://skills.sh/
步驟 4：檢視技能檔案
確認生成的 SKILL.md 檔案內容正確，包含 frontmatter 元數據與指令區塊。
cat demo-skill/SKILL.md
成功時會看到：輸出顯示 YAML frontmatter（name, description）以及 Markdown 標題 '# demo-skill'。（這一步我們花了 0.0 秒，結束碼 0）
## When to use Describe when this skill should be used. ## Instructions 1. First step 2. Second step 3. Additional steps as needed
步驟 5：列出已裝技能
驗證 CLI 是否能正確識別本地專案中的技能目錄結構。
skills list
成功時會看到：顯示 'Project Skills' 標題，並列出 'find-skills' 及其來源路徑。（這一步我們花了 0.1 秒，結束碼 0）
$ skills list Project Skills find-skills ~/lab/notes/vercel-labs-skills/src/skills/find-skills Agents: OpenClaw Source: local
步驟 6：搜尋線上技能
測試與 skills.sh 註冊表的連線，搜尋關鍵字 'web-design' 以驗證發現功能。
skills find web-design
成功時會看到：列出多個技能結果，第一筆為 'vercel-labs/agent-skills@web-design-guidelines' 並顯示安裝數 809.2K。（這一步我們花了 1.4 秒，結束碼 0）
secondsky/claude-skills@responsive-web-design 696 installs └ https://skills.sh/secondsky/claude-skills/responsive-web-design smithery.ai@web-design-reviewer 677 installs └ https://skills.sh/smithery.ai/web-design-reviewer uizze.com@ui-design 8 installs └ https://skills.sh/uizze.com/ui-design
步驟 7：移除測試技能
清理測試環境，確認移除指令的執行邏輯與錯誤處理機制。
skills remove demo-skill
成功時會看到：顯示 'Found 1 unique installed skill(s)' 以及 'No matching skills found for: demo-skill'。（這一步我們花了 0.1 秒，結束碼 0）
$ skills remove demo-skill │ ◇ Found 1 unique installed skill(s) │ ■ No matching skills found for: demo-skill
確認裝好了
執行 skills find web-design 後，若能成功從網路擷取並列出包含安裝次數的技能清單（如 vercel-labs/agent-skills@web-design-guidelines），且執行 skills init 能正確生成 SKILL.md 檔案，即代表安裝與核心功能運作正常。
可能遇到的問題
1. 若執行 git 指令時出現 'WARNING: terminal is not fully functional'，請按 Enter 鍵繼續即可，這通常不影響後續操作。
2. 執行 skills remove demo-skill 時若顯示 'No matching skills found'，請確認該技能是否已正確安裝至全域或專案範圍，而非僅存在於本地目錄。
接下來
安裝完成後，您可以編輯 demo-skill/SKILL.md 定義自己的代理行為，並透過 npx skills add <owner>/<repo> 安裝社群分享的技能，或將自製技能推播至 GitHub 以貢獻給開源社群。
