平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“OpenCode AI编程助手如何添加Skills的实现方式”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。
01 引言
从实现思路看，AI时代Agent的出现，为AI规定了特定的角色，根据推理、理解完成对话内容。MCP则是为AI或者Agent提供了外部资源的一切可能。比如，你让Agent为你播报近7天的天气，它无法完成，但是MCP可以，Agent结合MCP为我们带来无限的可能。原本以为到这里已经结束了，但是随着Skills的横空出世，更是推动了AI Agent更快落地。
从实现思路看，Skills的功能和MCP很类似但是却又不同，这一节我们将借助OpenCode了解最近爆火的Skills。
02 Skills
2.1 简介
Skills是智能体的技能，是一种轻量级、开放的格式，用来借助专业知识和工作流程扩展人工智能智能体的能力。而其本质上就是教 AI 按固定流程做事的操作说明书，一旦写好，就能像函数一样反复调用。
我们可以把 Skills 看成把什么样的事情应该怎么去做。将Skills封装成一个可复用、可自动触发的能力模块，根据实际的场景选择不同的Skills更加专业的完成用户下发的命令。可以轻松的理解为Skills就是一个个独立且可复用的工具包
Skills 以 Markdown 文件形式存在，不执行功能，而是借助按需、渐进式加载，实现高效且可复用的经验传递。
my-skill/ ├── SKILL.md # 必需：指令 + 元数据 ├── scripts/ # 可选：可执行代码 ├── references/ # 可选：文档资料 └── assets/ # 可选：模板、资源
地址：（链接已移除）
2.2 Skills核心结构
实际处理时，Skills 的核心就是：一堆文件夹 + 一个 SKILL.md 文件。
其中SKILL.md最为重要，借助定义角色，场景等，让Agent直到什么时候调用什么东西。Skill.md基本模版：
--- name: 你的Skill名称 description: Skill的相关描述以及什么时候使用 --- ## 说明 具体描述如何使用 ## 案例 - Example usage 1 - Example usage 2
在这个场景下，其他文件夹可以规范AI的操作或者调用的脚本。scripts放置一些可执行的脚本以及自动化的逻辑，references存放一些说明文档或者参考资料，assets主要用来存放模板文件以及静态资源。
有了这些文件夹资料以及md的说明，让Skills更加具体。
2.3 Skills的设置
实际处理时，Skills的设置可以分为局部设置和全局设置。我们以OpenCode为例：
还有一种全局设置：~/.opencode/skills/
官网地址：（链接已移除）
03 自定义Skills
结合项目来看，Skills的编写很轻松，轻松说就是提示词。但是如何写好，这个就另说了。我们轻松定义一个打印的Skills，我们按照模板编写。
--- name: print-test description: skill 打印测试 --- ## 角色定义 你是一个打印测试工具包 ## 输出 当用户测试打印的时候，统一打印出：这是一个skill的打印测试
3.1 局部设置
设置位置：.opencode/skills/print-test/SKILL.md
验证方式能够借助斜杠或者直接问AI都可以。
斜杠
输入斜杠，就会提示当前的技能。
直接问
全局设置不在演示。
3.2 测试
实际处理时，我们需测试自己定义的Skills是否有效。我们输入打印测试，看看回复是否是调用自定义Skills.
我们可以看到调用自定义的Skills.
04 优化项目
我们之前写了一个下载的页面，页面比较轻松：
结合项目来看，我们借助专业的Skills优化一下页面。采用ui-ux-pro-max优化。
Skills地址：（链接已移除）
从实现思路看，下载下来，将对应的包放在Skills即可，注意包的结构，本次采用全局设置。
4.1 全局设置
设置位置：~/.config/opencode/skills/
这里要注意src的包也要放进来，因为skills下的data和scripts路径需。
src位置：
4.2 检查
采用/检查
4.3 优化
这里直接让AI优化，看下会变成什么。
我们发现已经调用ui-ux-pro-max了。
最后总结了优化的效果：
我们直接看看结果：
结合项目来看，总的来说，OpenCode添加Skills这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。
