如何创建自定义 Agent Skills

简单说一下

这里不讲 Agent Skills 的定义和概念，可以看上一篇博客：Agent Skills: 如何为大语言模型构建可复用技能

这里使用 Gemini CLI 演示，因为博主的 Claude 过期了，没续期，Gemini 是白嫖的一年学生免费使用。

不过文档来看，还是 Anthropic 的更全，步骤更详细。大家想看官方文档的，直接看 Anthropic 的就好了。

自定义 SKills 详细说明：Claude - How to create custom skills

Skills 存放的位置

目前就看到了 Claude Agent SDK 有说明 skills 的使用（Agent skill in the sdk），其他官方框架没找到，注意是官方框架哦。

如果有其他大佬知道 OpenAI Agents sdk 和 Google Agent Development Kit 对 skill 的使用说明，麻烦贴一下连接在评论区，将不胜感激。

创建第一个 Skill

示例是用的 Gemini 官方的：Gemini CLI - Create a skill

Claude Code: Create your first skill

Openai(gpt): codex-create custom skill

1. 创建 Skill 目录

   每一个 Skill 就是一个单独的目录

   mkdir -p ~/.gemini/skills/code-reviewer-example
   

2. 在 ~/.gemini/skills/code-reviewer-example 目录下创建一个 SKILL.md 文件，内容示例：

   ---
   name: code-reviewer
   description:
     Expertise in reviewing code for style, security, and performance. Use when the
     user asks for "feedback," a "review," or to "check" their changes.
   ---
   
   # Code Reviewer
   
   You are an expert code reviewer. When reviewing code, follow this workflow:
   
   1.  **Analyze**: Review the staged changes or specific files provided. Ensure
       that the changes are scoped properly and represent minimal changes required
       to address the issue.
   2.  **Style**: Ensure code follows the project's conventions and idiomatic
       patterns as described in the `GEMINI.md` file.
   3.  **Security**: Flag any potential security vulnerabilities.
   4.  **Tests**: Verify that new logic has corresponding test coverage and that
       the test coverage adequately validates the changes.
   
   Provide your feedback as a concise bulleted list of "Strengths" and
   "Opportunities."
   

3. Gemini CLI 首次使用 Skill 需要先启用 (Claude code 不需要)

也可以直接改 ~/.gemini/settings.json 文件，添加：

{
  "experimental": {
    "skills": true
  }
}

• 在终端运行 gemini，进入交互界面，在交互界面输入 /settings

• 在 settings 中输入 skills，查看 Enable Agent Skills。

  • 如果是 false，则回车一次会变成 true, 按 esc
  • 如果是 true，就直接按 esc

  

4. 在上一步如果是交互设置，设置完成后，输入/quit 退出，再进入 gemini 交互终端。这时候就会有显示加载的 skill 和 存在 /skills 命令了，执行 /skills list 查看存在的 skills
   

5. 输入关键词触发skill，观察skill的过程，如：please check the code changes。

   可以看出 Gemini 对 skill 的使用过程跟 Claude 是一样的，细节可以看上一篇：Agent Skills: 如何为大语言模型构建可复用技能

   

   当允许后，它就会使用 skill 执行相应的任务
   

上面步骤是最简单的 Skill 示例，但是复杂的 Skill 不只是 SKILL.md 就能完成的。还有下面的资源定义：

• scripts/：代理可以运行的可执行脚本（bash、Python、Node）。
• references/：供代理查阅的静态文档、模式（schemas）或示例数据。
• assets/：代码模板、样板代码或二进制资源。

完整的 Skill 目录可能如下所示（Claude 官方 pdf 示例）：

pdf/
├── SKILL.md              # 主要说明（触发时加载）
├── FORMS.md              # 表单填充指南（根据需要加载）
├── reference.md          # API 参考（根据需要加载）
├── examples.md           # 使用示例（根据需要加载）
└── scripts/
    ├── analyze_form.py   # 实用脚本（执行，不加载）
    ├── fill_form.py      # 表单填充脚本
    └── validate.py       # 验证脚本

SKILL.md 元数据字段

在 YAML 前置部分中使用以下字段：

有关完整的编写指导，包括验证规则，请参阅最佳实践指南。

最佳实践

这里不单独写出来是因为篇幅很长，而且 Anthropics 的文档都支持切换语言，就没必要了。

文档说明：Claude Best practices

Github Skills 参考：Anthropics skills