如何创建自定义Agent Skills

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 
  
    
     现在openclaw非常火爆，我们可以通过各大SkillHub市场下载公开的各种Skills，但是对于很多时候，我们需要自己定义Skills，才能更好的为让小龙虾帮我们做我们自己的工作。

Skills 可以简单到几行指令，也可以复杂到包含可执行代码的多文件包。最好的 Skills：

解决特定的、可重复的任务
有 Claude 可以遵循的清晰指令
在有帮助时包含示例
定义何时应该使用它们
专注于一个工作流程，而不是试图做所有事情

每个 Skill 都包含一个目录，其中至少包含一个 Skill.md 文件，这是 Skill 的核心。此文件必须以 YAML 前置元数据开头，以保存名称和描述字段，这些是必需的元数据。它还可以包含其他元数据、参考文件、可执行脚本或工具。

必需的元数据字段

name: Skill 的人性化名称（最多 64 个字符）
示例：品牌指南
description: Skill 的功能及何时使用的清晰描述。
这很关键—— Agent 使用此信息来确定何时调用您的 Skill（最多 200 个字符）。
示例：将 Acme Corp 品牌指南应用于演示文稿和文档，包括官方颜色、字体和徽标使用。

可选元数据字段

详细可选字段参考Skills规范

Markdown 正文

Markdown 正文是元数据之后的第二级详细信息，因此如果需要，Agent 在读取元数据后将访问此内容。根据您的任务，Agent 可以访问 Skill.md 文件并使用 Skill。

Skill.md 示例

 元数据 name: Skill名称 description: 简洁描述这个技能的用途（1-3 句话）。 使用方法 在以下场景中启用此技能： - 用户请求代码审查时 - 用户提到 "review"、"检查代码" 等关键词时 指令 （以下是注入给 Agent 的实际指令内容） 你是一个专业的代码审查专家。在进行代码审查时，请遵循以下原则： 1. 安全性优先：首先检查是否存在注入漏洞、认证绕过等安全问题 2. 错误处理：确保所有错误都被妥善处理，不会导致崩溃 3. 可读性：评估命名是否清晰，注释是否充分 4. 性能：指出明显的性能瓶颈 审查格式： - 使用 ✅ 标记做得好的地方 - 使用 ⚠️ 标记需要改进的地方 - 使用 ❌ 标记必须修复的问题 每个问题都要给出具体的改进建议。

如果您有太多信息无法添加到单个 Skill.md 文件中（例如，仅适用于特定场景的部分），您可以通过在 Skill 目录中添加文件来添加更多内容。例如，向 Skill 目录添加包含补充和参考信息的 REFERENCE.md 文件。在 Skill.md 中引用它将帮助 Agent 决定在执行 Skill 时是否需要访问该资源。

对于更高级的 Skills，将可执行代码文件附加到 Skill.md，允许 Claude 运行代码。例如，我们的文档 Skills 使用以下编程语言和包：

Python（pandas、numpy、matplotlib）
JavaScript/Node.js
帮助进行文件编辑的包
可视化工具

注意：Agent 可以在加载 Skills 时从标准存储库（Python PyPI、JavaScript npm）安装包。对于 API Skills，无法在运行时安装其他包——所有依赖项必须预先安装在容器中。

Skill 文件夹完成后：

确保文件夹名称与您的 Skill 名称匹配。
创建文件夹的 ZIP 文件。
ZIP 应将 Skill 文件夹作为其根目录（不是子文件夹）。

正确的结构：

my-skill.zip └── my-skill/ ├── SKILL.md └── scripts/

不正确的结构：

my-skill.zip ├── SKILL.md # 文件直接在 ZIP 根目录中 └── scripts/

保持专注：为不同的工作流程创建单独的 Skills。多个专注的 Skills 比一个大型 Skill 组合得更好。
编写清晰的描述：Claude 使用描述来决定何时调用您的 Skill。具体说明何时适用。
从简单开始：在添加复杂脚本之前，先从 Markdown 中的基本说明开始。您可以稍后始终扩展 Skill。
使用示例：在您的 Skill.md 文件中包含示例输入和输出，以帮助 Claude 理解成功的样子。
增量测试：在每次重大更改后进行测试，而不是一次性构建复杂的 Skill。
Skills 可以相互构建：虽然 Skills 不能显式引用其他 Skills，但 Claude 可以自动一起使用多个 Skills。这种可组合性是 Skills 功能最强大的部分之一。
查看开放 Agent Skills 规范：遵循agentskills.io 上的指南，以便您创建的 Skills 可以在采用该标准的跨平台上工作。

在向 Skill.md 文件添加脚本时要谨慎。
不要硬编码敏感信息（API 密钥、密码）。
在启用之前查看您下载的任何 Skills。
使用适当的 MCP 连接来访问外部服务。

https://github.com/anthropics/skills

https://github.com/anthropics/skills/tree/main/skills

https://openclaw-docs.dx3n.cn/tutorials/tools/creating-skills

https://www.runoob.com/ai-agent/skills-agent.html