一、安装 OpenCode CLI

（已安装可忽略）

# 全局安装（推荐）
npm install -g opencode

# 或使用 npx（无需安装）
npx opencode <command>

---

二、Skill 安装方式

方式 1：从 GitHub 安装（最常用）

# 安装指定仓库的 Skill
npx skills add <owner>/<repo>

# 示例：安装官方示例
npx skills add anthropic-skills/web-search

# 自动确认安装（跳过提示）
npx skills add <owner>/<repo> -y

# 安装指定分支
npx skills add <owner>/<repo>#main -y

# 安装指定标签/版本
npx skills add <owner>/<repo>#v1.0.0 -y

方式 2：从本地路径安装

# 安装本地目录中的 Skill
npx skills add /path/to/local/skill

方式 3：从 Skills 市场安装

# 查看已安装的 Skills
npx skills list

# 搜索 Skills（通过第三方市场如 skills.sh 找到后安装）
npx skills add <marketplace-found-repo>

---

三、Skill 存储位置

范围	路径
项目级（推荐）	./.opencode/skill/<skill-name>/SKILL.md
全局级	~/.config/opencode/skill/<skill-name>/SKILL.md

项目级 Skill 优先级高于全局 Skill
【备注：也可以直接将下载的skill安装包直接放在存储位置，在.opencode目录下打开opencode，直接使用skill】

---

四、使用 Skill

自动触发

安装后，OpenCode 会自动识别 Skill 中的触发条件（关键词、文件模式等），在对话中自动调用。

手动调用

在 OpenCode 交互式对话中直接描述需求：

$ opencode
> 使用 web-search 技能搜索最新的 AI 新闻

查看 Skill 详情

# 列出所有已安装 Skills
npx skills list

# 查看特定 Skill 内容
cat .opencode/skill/<skill-name>/SKILL.md

---

五、Skill 文件结构示例

一个典型的 Skill 目录结构：

.opencode/skill/
└── web-search/
    ├── SKILL.md          # 主技能文件（必需）
    ├── README.md         # 说明文档
    └── assets/           # 辅助资源（可选）

SKILL.md 基本格式：

---
name: web-search
description: 搜索网络信息
tools: [browser, fetch]
---

当用户需要搜索信息时：
1. 使用 browser 工具访问搜索引擎
2. 提取关键信息并总结
3. 提供来源链接

---

六、更新与卸载

# 更新 Skill（重新安装最新版）
npx skills add <owner>/<repo> -y

# 手动删除
rm -rf .opencode/skill/<skill-name>

# 或删除全局 Skill
rm -rf ~/.config/opencode/skill/<skill-name>

---

七、常用命令速查

命令	作用
npx skills list	查看已安装 Skills
npx skills add <repo>	安装 Skill
npx skills add <repo> -y	静默安装
opencode	启动交互式对话
opencode <file>	分析指定文件

---

八、推荐 Skills 市场

• skills.sh - https://skills.sh（Vercel 官方排行榜）
• skillsmp.com - https://skillsmp.com/zh（中文友好）
• LobeHub - https://lobehub.com/skills（1500+ Skills）
• GitHub 搜索 - topic:opencode-skill