OpenCode Skills 配置与使用完全指南
最近 AI 编程圈子里，"Skills" 这个概念火得一塌糊涂。简单来说，Skills 就是给 AI 加的各种"技能包"，让它能更专业地完成特定任务——自动写代码、生成文档、做数据分析，甚至按照你公司的品牌规范来输出内容。
如果你正在用 OpenCode，或者打算尝试，这篇文章会带你从零开始，搞懂 Skills 到底是什么、怎么配置、怎么用。
什么是 Skills？
Skills 本质上是一组指令、脚本和资源的集合，AI 会在需要时动态加载它们。你可以把它理解成 AI 的"专业技能证书"——有了对应的 Skill，AI 就知道该怎么按照特定的方式完成任务。
举几个例子：
- 用公司品牌规范生成设计稿
- 按照团队的代码风格写代码
- 用特定的工作流分析数据
- 自动化处理日常重复性工作
每个 Skill 都是独立的文件夹，里面包含一个 SKILL.md 文件，这个文件定义了 AI 需要遵循的指令和元数据。
安装 OpenCode
在配置 Skills 之前，你得先把 OpenCode 装好。
下载安装
访问官网下载：https://opencode.ai/download
Windows 用户安装完成后，会看到三个程序：
- OpenCode.exe — 桌面端，带图形界面，操作直观
- OpenCode-cli.exe — 命令行模式，适合喜欢终端的用户
- uninstall.exe — 卸载程序
Mac 和 Linux 用户按照官网指引安装即可。
Skills 的存放位置
OpenCode 会在以下位置搜索 Skills：
- 全局目录：
~/.opencode/（所有项目共享） - 项目目录：
项目根目录/.opencode/（仅当前项目可用）
这种分层设计很实用——全局放通用技能，项目目录放专属技能。
安装 Skills 的三种方式
方式一：从 GitHub 下载官方 Skills
这是最简单的入门方式。
- 在 OpenCode 安装目录下创建
.opencode文件夹（注意是点开头） - 从 GitHub 下载官方 Skills：https://github.com/anthropics/skills
- 把下载的 skills 文件夹复制到
.opencode目录 - 打开 OpenCode，输入
/init回车
OpenCode 会自动扫描并加载这些 Skills。验证一下，问它"我能使用什么 skills？"，应该能看到已加载的技能列表。
方式二：通过插件市场安装
在 Claude Code 中，可以用命令行直接安装：
# 添加官方插件市场
/plugin marketplace add anthropics/skills
# 安装文档技能包
/plugin install document-skills@anthropic-agent-skills
# 安装示例技能包
/plugin install example-skills@anthropic-agent-skills
方式三：创建自己的 Skills
这才是 Skills 真正强大的地方。你可以根据自己的需求定制专属技能。
创建自定义 Skill
一个 Skill 的基本结构很简单：
SKILL.md 文件包含两部分：YAML 元数据和 Markdown 指令。
基础模板
---
name: my-skill-name
description: 清晰描述这个技能做什么、什么时候用
---
# 技能名称
[这里写 AI 需要遵循的具体指令]
## 使用示例
- 示例 1
- 示例 2
## 注意事项
- 注意点 1
- 注意点 2
元数据只需要两个字段：
- name：技能的唯一标识，小写字母，用连字符分隔
- description：完整描述技能的功能和使用场景
实战：让 AI 帮你创建 Skill
最省事的方法是让 OpenCode 自己来生成。输入 @skill-creator，然后描述你想要的功能：
@skill-creator 帮我创建一个技能，用于生成符合我们团队规范的 API 文档，
要求包含接口描述、请求参数、响应格式和错误码说明
OpenCode 会根据你的描述自动生成对应的 Skill 配置文件。
常用操作指令
掌握这几个指令，日常使用基本够了：
| 指令 | 功能 |
|---|---|
/init |
初始化项目，扫描并加载 Skills |
/models |
列出并切换可用模型 |
/connect |
添加自己的模型 API |
/new |
开始新对话 |
/sessions |
查看历史对话 |
/compact |
压缩对话内容，节省上下文 |
/undo |
撤销上一步操作 |
/help |
显示帮助 |
另外，用 Tab 键 可以在 Plan 和 Build 模式之间切换。Plan 模式用于规划，Build 模式用于执行。
调用 Skills 的方法
有两种方式：
- 自动触发：在对话中提到相关内容，OpenCode 会自动识别并调用对应的 Skill
- 手动指定：用
@符号明确指定，比如@pdf 提取这个文件的表格数据
配置模型 API
OpenCode 默认提供免费模型，但稳定性一般。建议配置自己的 API。
- 输入
/connect - 选择你的模型供应商（支持 Anthropic、OpenAI、阿里云等）
- 粘贴 API Key，回车确认
API 配置会保存在：~/.local/share/opencode/auth.json
配置文件说明
OpenCode 支持两级配置：
- 全局配置：
~/.config/opencode/opencode.json - 项目配置：
项目目录/opencode.json
项目配置会覆盖全局配置，这样你可以为不同项目设置不同的偏好。
官方 Skills 推荐
官方仓库里有不少实用的 Skills：
- docx — Word 文档处理
- pdf — PDF 文档处理
- pptx — PPT 演示文稿
- xlsx — Excel 表格处理
- brand-guidelines — 品牌规范应用
- skill-creator — 创建新 Skills
- mcp-builder — 构建 MCP 服务器
这些 Skills 覆盖了文档处理、设计、开发等多个场景，可以根据需要选用。
常见问题
Q：Skills 加载不出来怎么办？
检查文件夹结构是否正确，确保 SKILL.md 文件存在且格式正确。然后重新执行 /init。
Q：不知道某个 Skill 怎么用？
直接问 OpenCode：@skill名称 这个 skill 如何使用？
Q：想了解更多操作？
在 OpenCode 里直接提问，它会告诉你具体的操作方法。
写在最后
Skills 的核心价值在于"可复用"和"可定制"。你可以把团队的最佳实践、公司的规范要求、个人的工作习惯都封装成 Skills，让 AI 按照你期望的方式工作。
从简单的开始，先用官方提供的 Skills 熟悉一下，然后尝试创建自己的。一旦上手，你会发现这东西确实能省不少事。