安裝第一個技能

學完你能做什麼

從 Anthropic 官方倉庫安裝技能到你的專案
使用互動式選擇介面選擇需要的技能
理解技能被安裝到哪裡（.claude/skills/ 目錄）
驗證技能是否成功安裝

前置知識

本教學假設你已經完成了 OpenSkills 的安裝。如果你還沒有安裝，請先完成安裝步驟。

你現在的困境

你可能剛安裝完 OpenSkills，但是：

不知道從哪裡找技能：GitHub 上有很多技能倉庫，不知道哪個是官方的
不知道怎麼安裝技能：只知道有個 install 指令，但不知道怎麼用
擔心裝錯位置：怕技能裝到系統全域，專案換了就找不到了

這些問題其實很常見。讓我們一步步來解決。

什麼時候用這一招

安裝第一個技能適合這些場景：

第一次使用 OpenSkills，想快速體驗
需要使用 Anthropic 官方提供的技能（如 PDF 處理、Git 工作流程等）
想在目前的專案中使用技能，而不是全域安裝

推薦做法

首次安裝建議從 Anthropic 官方倉庫 anthropics/skills 開始，這些技能品質高且經過驗證。

🎒 開始前的準備

在開始之前，請確認：

[ ] 已完成 OpenSkills 安裝
[ ] 已進入你的專案目錄
[ ] 已設定 Git（用於複製 GitHub 倉庫）

前置檢查

如果你還沒有專案目錄，可以建立一個暫存目錄來練習：

bash

mkdir my-project && cd my-project

核心思路：從 GitHub 安裝技能

OpenSkills 支援從 GitHub 倉庫安裝技能。安裝過程是這樣的：

[指定倉庫] → [複製到暫存目錄] → [尋找 SKILL.md] → [互動式選擇] → [複製到 .claude/skills/]

關鍵點：

使用 owner/repo 格式指定 GitHub 倉庫
工具會自動複製倉庫到暫存目錄
尋找所有包含 SKILL.md 的子目錄
透過互動式介面選擇要安裝的技能
技能被複製到專案的 .claude/skills/ 目錄

跟我做

第 1 步：進入專案目錄

首先，進入你正在開發的專案目錄：

bash

cd /path/to/your/project

為什麼

OpenSkills 預設將技能安裝到專案的 .claude/skills/ 目錄，這樣技能可以隨專案版本控制，團隊成員也能共享。

你應該看到：

你的專案目錄應該包含以下內容之一：

.git/ （Git 倉庫）
package.json （Node.js 專案）
其他專案檔案

推薦做法

即使是一個新專案，也建議先初始化 Git 倉庫，這樣可以更好地管理技能檔案。

第 2 步：安裝技能

使用以下指令從 Anthropic 官方技能倉庫安裝技能：

bash

npx openskills install anthropics/skills

為什麼

anthropics/skills 是 Anthropic 官方維護的技能倉庫，包含高品質的技能範例，適合第一次體驗。

你應該看到：

指令會啟動一個互動式選擇介面：

Installing from: anthropics/skills
Location: project (.claude/skills)
Default install is project-local (./.claude/skills). Use --global for ~/.claude/skills.

Cloning repository...
✓ Repository cloned

Found 4 skill(s)

? Select skills to install:
❯ ◉ pdf (24 KB)    Comprehensive PDF manipulation toolkit for extracting text and tables...
  ◯ git-workflow (12 KB)   Git workflow: Best practices for commits, branches, and PRs...
  ◯ check-branch-first (8 KB)    Git workflow: Always check current branch before making changes...
  ◯ skill-creator (16 KB)   Guide for creating effective skills...

<Space> 選擇  <a> 全選  <i> 反選  <Enter> 確認

操作指南：

┌─────────────────────────────────────────────────────────────┐
│  操作說明                                                    │
│                                                             │
│  第 1 步         第 2 步          第 3 步                   │
│  移動游標   →   按 Space 選取   →   按 Enter 確認           │
│                                                             │
│  ○ 未選取           ◉ 已選取                                │
└─────────────────────────────────────────────────────────────┘

你應該看到：
- 游標可以上下移動
- 按空白鍵切換選取狀態（○ ↔ ◉）
- 按 Enter 鍵確認安裝

第 3 步：選擇技能

在互動式介面中，選擇你想安裝的技能。

範例：

假設你想安裝 PDF 處理技能：

? Select skills to install:
❯ ◉ pdf (24 KB)    ← 選取這個
  ◯ git-workflow (12 KB)
  ◯ check-branch-first (8 KB)
  ◯ skill-creator (16 KB)

操作：

移動游標：使用上下方向鍵移動到 pdf 這一行
選取技能：按 空白鍵，確保前面是 ◉ 而不是 ◯
確認安裝：按 Enter 鍵 開始安裝

你應該看到：

✅ Installed: pdf
   Location: /path/to/your/project/.claude/skills/pdf

Skills installed to: /path/to/your/project/.claude/skills/

Next steps:
  → Run openskills sync to generate AGENTS.md with your installed skills
  → Run openskills list to see all installed skills

進階操作

如果你想一次安裝多個技能：

按空白鍵選取每個需要的技能（多個 ◉）
按 <a> 全選所有技能
按 <i> 反選目前選擇

第 4 步：驗證安裝

安裝完成後，驗證技能是否成功安裝到專案目錄。

檢查目錄結構：

bash

ls -la .claude/skills/

你應該看到：

.claude/skills/
└── pdf/
    ├── SKILL.md
    ├── .openskills.json
    ├── references/
    │   ├── pdf-extraction.md
    │   └── table-extraction.md
    └── scripts/
        └── extract-pdf.js

關鍵檔案說明：

檔案	用途
`SKILL.md`	技能的主要內容和指令
`.openskills.json`	安裝元資料（記錄來源，用於更新）
`references/`	參考文件和詳細說明
`scripts/`	可執行腳本

查看技能元資料：

bash

cat .claude/skills/pdf/.openskills.json

你應該看到：

json

{
  "source": "anthropics/skills",
  "sourceType": "git",
  "repoUrl": "https://github.com/anthropics/skills",
  "subpath": "pdf",
  "installedAt": "2026-01-24T10:30:00.000Z"
}

這個元資料檔案記錄了技能的來源資訊，後續使用 openskills update 時會用到。

檢查點 ✅

完成上述步驟後，請確認：

[ ] 指令列顯示了互動式選擇介面
[ ] 成功選取了至少一個技能（前面是 ◉）
[ ] 安裝成功，顯示了 ✅ Installed: 訊息
[ ] .claude/skills/ 目錄已建立
[ ] 技能目錄中包含 SKILL.md 檔案
[ ] 技能目錄中包含 .openskills.json 元資料檔案

如果以上檢查項目都通過，恭喜你！第一個技能安裝成功。

踩坑提醒

問題 1：複製倉庫失敗

現象：

✗ Failed to clone repository
fatal: repository 'https://github.com/anthropics/skills' not found

原因：

網路連線問題
GitHub 倉庫地址錯誤

解決方法：

檢查網路連線：ping github.com
確認倉庫地址是否正確（owner/repo 格式）

問題 2：沒有互動式選擇介面

現象：

指令直接安裝了所有技能，沒有出現選擇介面。

原因：

倉庫中只有一個 SKILL.md 檔案（單一技能倉庫）
使用了 -y 或 --yes 標誌（跳過選擇）

解決方法：

如果是單一技能倉庫，這是正常行為
如果需要選擇，去掉 -y 標誌

問題 3：權限錯誤

現象：

Error: EACCES: permission denied, mkdir '.claude/skills'

原因：

解決方法：

問題 4：找不到 SKILL.md

現象：

Error: No SKILL.md files found in repository

原因：

倉庫中沒有符合格式的技能檔案

解決方法：

確認倉庫是否為技能倉庫
檢查倉庫中的目錄結構

本課小結

透過本課，你學會了：

使用 openskills install anthropics/skills 從官方倉庫安裝技能
在互動式介面中選擇技能，使用空白鍵選取，Enter 確認
技能安裝到 .claude/skills/ 目錄，包含 SKILL.md 和元資料
驗證安裝成功，檢查目錄結構和檔案內容

核心指令：

指令	作用
`npx openskills install anthropics/skills`	從官方倉庫安裝技能
`ls .claude/skills/`	查看已安裝技能
`cat .claude/skills/<name>/.openskills.json`	查看技能元資料

下一課預告

下一課我們學習 使用技能。
你會學到：
使用 openskills read 指令讀取技能內容
理解 AI 代理如何載入技能到上下文
掌握技能查找的 4 級優先級順序

安裝技能只是第一步，接下來需要了解 AI 代理如何使用這些技能。

附錄：原始碼參考

點擊展開查看原始碼位置

更新時間：2026-01-24

功能	檔案路徑	行號
安裝指令入口	`src/commands/install.ts`	83-183
安裝位置判斷（project vs global）	`src/commands/install.ts`	84-92
GitHub shorthand 解析	`src/commands/install.ts`	131-143
倉庫複製	`src/commands/install.ts`	155-169
遞迴尋找技能	`src/commands/install.ts`	358-373
互動式選擇介面	`src/commands/install.ts`	427-455
技能複製和安裝	`src/commands/install.ts`	461-486
官方技能列表（衝突警告）	`src/utils/marketplace-skills.ts`	1-25

關鍵函式：

installFromRepo() - 從倉庫安裝技能，支援互動式選擇
installSpecificSkill() - 安裝指定子路徑的技能
installFromLocal() - 從本機路徑安裝技能
warnIfConflict() - 檢查並警告技能衝突

關鍵常數：

ANTHROPIC_MARKETPLACE_SKILLS - Anthropic Marketplace 的技能列表，用於衝突警告

安裝第一個技能 ​

學完你能做什麼 ​

你現在的困境 ​

什麼時候用這一招 ​

🎒 開始前的準備 ​

核心思路：從 GitHub 安裝技能 ​

跟我做 ​

第 1 步：進入專案目錄 ​

第 2 步：安裝技能 ​

第 3 步：選擇技能 ​

第 4 步：驗證安裝 ​

檢查點 ✅ ​

踩坑提醒 ​

問題 1：複製倉庫失敗 ​

問題 2：沒有互動式選擇介面 ​

問題 3：權限錯誤 ​

問題 4：找不到 SKILL.md ​

本課小結 ​

下一課預告 ​

附錄：原始碼參考 ​

安裝第一個技能

學完你能做什麼

你現在的困境

什麼時候用這一招

🎒 開始前的準備

核心思路：從 GitHub 安裝技能

跟我做

第 1 步：進入專案目錄

第 2 步：安裝技能

第 3 步：選擇技能

第 4 步：驗證安裝

檢查點 ✅

踩坑提醒

問題 1：複製倉庫失敗

問題 2：沒有互動式選擇介面

問題 3：權限錯誤

問題 4：找不到 SKILL.md

本課小結

下一課預告

附錄：原始碼參考