OpenCode Skills
一、什么是 Skills?
Skills 是 AI 编程助手(如 OpenCode、Claude Code)的能力扩展模块,用于:
- 注入特定领域的最佳实践(如 TDD、React 规范)
- 提供标准化工作流(调试、规划、代码审查)
- 赋予外部记忆能力(解决上下文丢失)
二、安装方式对比
| 方式 |
命令/安装 |
适用场景 |
| skills CLI(推荐) |
npx skills add <仓库> |
通用安装,支持远程/本地技能 |
| Agent Reach |
pip install ... + agent-reach install |
从 RSS、网页、GitHub 等多源获取信息 |
2.1 skills CLI 常用命令
npx skills list
npx skills add owner/repo -y
npx skills add owner/repo
npx skills add ./my-skill-folder
npx skills update owner/repo
npx skills remove skill-name
2.2 Agent Reach(可选,用于信息采集类技能)
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto --safe
支持源:RSS/Atom、任意网页、GitHub(需 gh CLI)、B站/YouTube(需 yt-dlp)
三、必装技能清单(分类详解)
🔥 项目开发类
| 技能 |
命令 |
核心功能 |
| superpowers |
npx skills add obra/superpowers -y |
包含 14 个子技能:头脑风暴、TDD、系统化调试、代码审查、重构、文档生成。适合高质量大型项目。 |
| planning-with-files |
npx skills add OthmanAdi/planning-with-files -y |
用三个 MD 文件(task_plan.md / findings.md / progress.md)作为外部记忆,解决长对话中 AI 遗忘问题。 |
| vercel-labs/agent-skills |
npx skills add vercel-labs/agent-skills -y |
React/Next.js 性能优化、Web 设计规范、一键部署 Vercel。 |
🎨 内容创作类
| 技能 |
命令 |
核心功能 |
| remotion-dev/skills |
npx skills add remotion-dev/skills -y |
用 React 组件生成程序化视频/动画,支持音乐可视化。 |
| baoyu-skills |
npx skills add JimLiu/baoyu-skills -y |
18 个技能:公众号文章写作/发布、封面图/小红书配图、PPT 生成、信息图、Markdown/HTML 互转等。 |
🛠️ 技能管理类
| 技能 |
命令 |
核心功能 |
| anthropics/skills |
npx skills add anthropics/skills -y |
官方 skill-creator(引导式创建自定义技能)、文档协作、品牌规范。 |
| vercel-labs/skills |
npx skills add vercel-labs/skills -y |
交互式搜索并推荐技能,快速发现新技能。 |
一键安装所有推荐技能(7个仓库)
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
四、如何使用已安装的技能
4.1 斜杠命令调用(在 OpenCode 对话框中)
/planning-with-files # 创建任务规划文件
/brainstorming # 启动头脑风暴
/skill-creator # 引导创建自定义技能
4.2 自然语言自动激活
OpenCode 会根据你的描述自动匹配技能:
| 你说的话 |
自动激活的技能 |
| “帮我用 TDD 写个登录功能” |
test-driven-development |
| “调试这个报错” |
systematic-debugging |
| “规划一下这个项目,分步骤做” |
planning-with-files |
| “给我的文章生成小红书风格配图” |
baoyu-xhs-images |
五、自定义技能开发
5.1 创建流程
/skill-creator
5.2 技能目录结构
~/.claude/skills/ # Claude Code 默认路径
~/.cursor/skills/ # Cursor 路径
└── my-skill/
├── SKILL.md # 必需:技能定义文件
├── commands/ # 可选:斜杠命令脚本
└── resources/ # 可选:模板/数据文件
5.3 SKILL.md 模板
# 技能名称
## 描述
一句话说明技能作用。
## 触发条件
- 关键词A
- 关键词B
## 工作流程
1. 步骤一
2. 步骤二
## 输出格式
期望的输出结构示例。
六、常见问题
| 问题 |
解决方法 |
| 安装后找不到技能 |
① 重启 OpenCode;② npx skills list 确认存在;③ 检查 ~/.claude/skills/ 目录 |
| 技能存在但不触发 |
在对话中明确使用斜杠命令,或说出技能的关键触发词 |
| 如何更新所有技能 |
逐个 npx skills update <repo>,或删除后重装 |
| 多平台同步 |
skills CLI 会自动同步到 ~/.claude/skills/、~/.cursor/skills/ 等 |
七、技能资源平台
| 平台 |
地址 |
特点 |
| skills.sh |
https://skills.sh |
Vercel 官方,按安装量/趋势排序 |
| skillsmp |
https://skillsmp.com/zh |
中文分类,按 GitHub Star 排序 |
| awesome-claude-skills |
https://github.com/ComposioHQ/awesome-claude-skills |
全网最全精选列表 |
| vue-skills |
https://github.com/vuejs-ai/skills |
Vue 3 生态专用 |
八、总结速查表
| 需求 |
推荐技能 |
| 大型项目开发 |
superpowers + planning-with-files |
| 前端 React/Next.js |
vercel-labs/agent-skills |
| 视频动画 |
remotion-dev/skills |
| 公众号/小红书内容 |
baoyu-skills |
| 创建自己的技能 |
anthropics/skills |
| 发现新技能 |
vercel-labs/skills(find-skills) |
所有评论(0)