安装第一个技能

学完你能做什么

从 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 确认           │
│                                                             │
│  ○ 未选中           ◉ 已选中                                │
└─────────────────────────────────────────────────────────────┘

你应该看到：
- 光标可以上下移动
- 按空格键切换选中状态（○ ↔ ◉）
- 按回车键确认安装

第 3 步：选择技能

在交互式界面中，选择你想安装的技能。

示例：

假设你想安装 PDF 处理技能：

? Select skills to install:
❯ ◉ pdf (24 KB)    ← 选中这个
  ◯ git-workflow (12 KB)
  ◯ check-branch-first (8 KB)
  ◯ skill-creator (16 KB)

操作：

移动光标：使用上下方向键移动到 pdf 这一行
选中技能：按 空格键，确保前面是 ◉ 而不是 ◯
确认安装：按 回车键 开始安装

你应该看到：

✅ 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 从官方仓库安装技能
在交互式界面中选择技能，使用空格键选中，回车确认
技能安装到 .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 的技能列表，用于冲突警告

15 分钟上手

掌握核心操作

多账号与自定义技能

遇到问题怎么办

遇到问题查这里

了解最新改动

安装第一个技能

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

核心思路：从 GitHub 安装技能

跟我做

第 1 步：进入项目目录

第 2 步：安装技能

第 3 步：选择技能

第 4 步：验证安装

检查点 ✅

踩坑提醒

问题 1：克隆仓库失败

问题 2：没有交互式选择界面

问题 3：权限错误

问题 4：找不到 SKILL.md

本课小结

下一课预告

附录：源码参考

安装第一个技能 ​

学完你能做什么 ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

核心思路：从 GitHub 安装技能 ​

跟我做 ​

第 1 步：进入项目目录 ​

第 2 步：安装技能 ​

第 3 步：选择技能 ​

第 4 步：验证安装 ​

检查点 ✅ ​

踩坑提醒 ​

问题 1：克隆仓库失败 ​

问题 2：没有交互式选择界面 ​

问题 3：权限错误 ​

问题 4：找不到 SKILL.md ​

本课小结 ​

下一课预告 ​

附录：源码参考 ​

安装第一个技能

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

核心思路：从 GitHub 安装技能

跟我做

第 1 步：进入项目目录

第 2 步：安装技能

第 3 步：选择技能

第 4 步：验证安装

检查点 ✅

踩坑提醒

问题 1：克隆仓库失败

问题 2：没有交互式选择界面

问题 3：权限错误

问题 4：找不到 SKILL.md

本课小结

下一课预告

附录：源码参考