skills技能

Skills 的核心是一个简单的文件夹结构，包含一个必需的 SKILL.md 文件。这个文件使用 YAML 前置元数据和 Markdown 指令来定义 Skill 的功能和使用方式

• AI 的 Skills（技能） 可以理解为赋予 AI 的“额外超能力”或“插件”
• 定义可复用行为的方式
• 通过skills.md文件来描述具体要操作的事情，让ai能够更清楚知道用户的需求，快速找到对应的技能模块，而不是盲目的去搜索整个知识库，是针对性的快速找到技能
• 利于skills可以让ai按照制定的标准流程来进行工作

场景：

• code reviews技能
• 代码发布技能
• 代码优化技能
• 等等

安装skills

• 通过软链接，安装的目录在.agents/skills

bash

# 全局安装，需要加 -g, 不加的话，默认是安装到当前项目作用域
npx skills add -g vercel-labs/agent-skills

skills和mcp区别

• skills用于给ai的操作手册，告诉ai按照什么步骤以及标准来进行处理

• mcp用于操作外部工具，如操作figma来读取设计图来快速生成页面，如查询数据库等等

• skills和mcp是互补，通常是一起使用

如何配置 Skills

skills相关文件结构

必需文件

• SKILL.md：核心指令文件，包含元数据和使用指南

可选文件

• scripts/：可执行脚本和代码
• references/：附加文档和参考资料
• assets/：模板、资源文件等

放置文件位置

创建文件夹并在其中放置 SKILL.md 文件：

位置	路径
项目配置	.opencode/skill/<name>/SKILL.md
全局配置	~/.config/opencode/skill/<name>/SKILL.md
项目 Claude 兼容	.claude/skills/<name>/SKILL.md
全局 Claude 兼容	~/.claude/skills/<name>/SKILL.md

skill-creator 技能创建器

• skill-creator是技能创建器
• 能帮助你自动生成 Skill 文件的 Skill
• skill-creator = 帮你把“自然语言需求”快速生成一个 Agent Skill 的脚手架工具
• 自然语言需求 => skill-creator => 生成标准 Skill
• 通过skill-creator解决了手写skills的繁琐

skill-creator具备：

• 引导你一步一步描述要创建的技能
• 自动输出正确格式的 SKILL.md（带 frontmatter、用例示例等）
• 生成完整的目录结构（包括示例与资源）
• 支持迭代改进 Skill 内容

通过Symlink 软链接安装

• 当通过npm方式来安装skills时，会选择相关模型添加到对应skills，以及会选择添加skills的方式是软连接还是直接copy目录，推荐是软链接
• pnpx skills add 将 SKILL.md 文件复制/符号链接到 agent 的 skills 目录（如 ~/.config/opencode/skills/）

推荐通过Symlink安装 （Symlink 是软链接方式安装）

• 单一来源 - 所有 agent 指向同一套 skills
• 易于更新 - 更新一次，所有 agent 同步生效
• 节省空间 - 不重复存储相同文件
• 软链接可以让多个 agent 共享同一个来源
• 更新 Skills 源时，所有链接自动指向新版本

Agent 是怎么用这些skills技能的

当你在支持 agent skill 的系统里问类似：

• “帮我优化这个 React 页面性能”
• “审查这个 UI 是否符合最佳实践”
• “部署我的项目到线上并给我链接”

Agent 会自动检查匹配对应的skills：

• Agent 根据上下文判断，或用户明确提及
• 检查你安装的技能列表
• 匹配最相关的 skill（如 react-best-practices / vercel-deploy）
• 根据 SKILL.md 和脚本去执行、生成实际建议或自动操作

配置 AGENTS.md

• 通过配置 AGENTS.md定制相关规则，明确告诉 Agent 使用哪些 skills

使用技巧

• 1、安装常用的skills, 不要安装太多，否则会影响agent的效率
• 2、skills位置：通用skills能力放全局，跟项目相关的安装在项目中