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

# 从 GitHub 安装(-y 跳过确认)
npx skills add owner/repo -y

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

# 安装本地开发中的技能
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)
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐