OpenCode Skills 安装完全攻略

让你的 AI 编程助手战斗力翻倍的终极指南

什么是 Skills？

Skills（技能）是 Agent 的能力扩展模块，就像给 AI 装上专业技能包。通过安装不同的 Skills，你的 OpenCode 可以：

• 🎯 掌握特定领域的最佳实践
• 🔧 获得专业工具的操作能力
• 📝 执行标准化的工作流程
• 🧠 拥有外部记忆和规划能力

一、安装方式总览

方式一：skills CLI（推荐）

Vercel 官方提供的命令行工具，最简单直接：

# 查看已安装的技能
npx skills list

# 安装技能（-y 自动确认）
npx skills add <owner/repo> -y

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

# 安装本地技能
npx skills add ./path/to/skill

方式二：Agent Reach

专为信息获取设计的工具，支持 RSS、网页、GitHub 仓库等多渠道：

# 安装
pip install https://github.com/Panniantong/agent-reach/archive/main.zip

# 配置（自动检测环境）
agent-reach install --env=auto --safe

支持的信息源：

• ✅ RSS/Atom 订阅源
• ✅ 任意网页（通过 Jina Reader）
• ⬜ GitHub 仓库（需安装 gh CLI）
• ⬜ YouTube/B站视频（需安装 yt-dlp）

二、必装 Skills 推荐

🔥 项目开发（程序员必备）

1. superpowers - 完整 AI 编程框架

npx skills add obra/superpowers -y

包含 14 个技能：

适用场景： 大型项目开发、高质量代码产出、团队协作

2. planning-with-files - 最强外部记忆

npx skills add OthmanAdi/planning-with-files -y

核心能力：

• 📝 使用 Markdown 文件作为外部记忆
• 🔄 解决 AI 上下文丢失问题
• 📋 任务规划与进度追踪
• 🎯 复杂项目不跑偏

工作原理： 借鉴 Manus AI 的核心模式，创建 task_plan.md、findings.md、progress.md 三个文件，让 AI 始终保持项目全局视图。

适用场景： 复杂多步骤任务、长周期项目、研究分析

3. vercel-labs/agent-skills - React/Next.js 最佳实践

npx skills add vercel-labs/agent-skills -y

包含技能：

• vercel-react-best-practices - React 性能优化规范
• web-design-guidelines - Web 界面设计规范
• vercel-deploy - 一键部署到 Vercel

适用场景： 前端开发、React/Next.js 项目、Web 应用部署

🔥 内容创作（博主/创作者必备）

4. remotion-dev/skills - 视频动画生成

npx skills add remotion-dev/skills -y

核心能力：

• 🎬 一句话生成专业动画
• 🎨 可编辑的 React 组件
• 📹 程序化视频制作
• 🎵 音乐可视化

适用场景： 教程视频、产品演示、社交媒体内容

5. baoyu-skills - 宝玉老师自用合集

npx skills add JimLiu/baoyu-skills -y

包含 18 个技能：

适用场景： 内容创作者完整工作流、自媒体运营

🔥 Skills 管理

6. anthropics/skills - 官方技能创建工具

npx skills add anthropics/skills -y

包含技能：

• skill-creator - 引导式创建自定义技能
• doc-coauthoring - 协作式文档编写
• brand-guidelines - 品牌规范应用

7. vercel-labs/skills - find-skills 工具

npx skills add vercel-labs/skills -y

核心能力：

• 🔍 交互式搜索技能
• 📦 快速定位安装
• 🎯 按需求推荐

三、一站式安装命令

# 复制以下命令，一次性安装全部推荐技能

npx skills add obra/superpowers -y
npx skills add OthmanAdi/planning-with-files -y
npx skills add vercel-labs/agent-skills -y
npx skills add remotion-dev/skills -y
npx skills add JimLiu/baoyu-skills -y
npx skills add anthropics/skills -y
npx skills add vercel-labs/skills -y

# 验证安装
npx skills list

预计安装技能总数：41+

四、Skills 资源平台

在线市场

开源仓库精选

五、如何使用已安装的 Skills

在 OpenCode 中调用

# 方式一：斜杠命令
/planning-with-files
/brainstorming
/skill-creator

# 方式二：自然语言描述
"帮我用 TDD 的方式开发一个用户登录功能"
"给我的文章生成一张小红书风格的配图"
"创建一个关于项目架构的 planning 文件"

技能自动激活

OpenCode 会根据你的描述自动识别并激活相关技能：

• 说 "调试 bug" → 自动调用 systematic-debugging
• 说 "规划项目" → 自动调用 planning-with-files
• 说 "写公众号文章" → 自动调用 blog-post-writer

六、自定义 Skills

创建自己的技能

# 使用官方 skill-creator
/skill-creator

Skills 目录结构

~/.claude/skills/
├── my-custom-skill/
│   ├── SKILL.md          # 技能说明文档
│   ├── commands/         # 斜杠命令
│   └── resources/        # 资源文件

SKILL.md 模板

# 技能名称

## 描述
一句话描述这个技能的作用

## 触发条件
- 关键词1
- 关键词2

## 工作流程
1. 步骤一
2. 步骤二
3. 步骤三

## 输出格式
描述期望的输出格式

七、常见问题

Q: Skills 安装到哪里了？

Skills 会自动同步到多个 Agent 平台：

• ~/.claude/skills/ - Claude Code
• ~/.openclaw/skills/ - OpenClaw
• ~/.agents/skills/ - 其他 Agent
• ~/.cursor/skills/ - Cursor

Q: 如何更新已安装的 Skills？

npx skills update <owner/repo>

Q: 如何删除不需要的 Skills？

npx skills remove <skill-name>

Q: 安装后找不到技能？

1. 重启 OpenCode
2. 检查 npx skills list 是否显示
3. 确认 ~/.claude/skills/ 目录存在

八、进阶推荐

浏览器自动化

npx skills add browser-use/browser-use -y    # 网站操作、自动化测试

人机协同

# MapleClaw 枫爪 - 人机共生协同平台
# https://gitee.com/hongmaple/mapleclaw

网站审计

npx skills add coreyhaines31/marketingskills -y  # SEO 审计

总结

一句话总结： 用 npx skills add 安装技能，用斜杠命令或自然语言调用，让 OpenCode 成为你的全能编程助手。

📝 文档更新时间：2025年3月

🙏 感谢 Vercel、Anthropic 及开源社区的贡献