by 运行时依赖
安装命令
点击复制技能文档
创建技能模板 这是一个用于创建新Agent Skills的元技能。当您需要创建一个新技能文件夹、生成一个SKILL.md文件或帮助用户理解Agent Skills规范时，请使用此技能。
何时使用此技能 用户要求“创建一个技能”、“创建一个新技能”或“创建一个技能框架” 用户希望向其GitHub Copilot设置添加专门的功能 用户需要帮助使用捆绑资源来结构一个技能 用户希望将此模板作为起点复制
先决条件 了解技能应该实现的功能 对功能和触发器的清晰、关键字丰富的描述 了解所需的任何捆绑资源（脚本、参考、资产、模板）
创建一个新技能 步骤 1：创建技能目录 创建一个新文件夹，名称为小写、连字符：skills/<技能名称>/ └── SKILL.md # 必需
步骤 2：生成带有前置内容的SKILL.md 每个技能都需要带有名称和描述的YAML前置内容：
名称：<技能名称> 描述：'<它的功能>. 使用时 <特定触发器、场景、关键字用户可能会说>。'
前置内容字段要求 字段 是否必需 限制 名称 是 1-64 个字符，仅小写字母、数字和连字符，必须与文件夹名称匹配 描述 是 1-1024 个字符，必须描述它的功能和何时使用 许可证 否 许可证名称或对捆绑LICENSE.txt的引用 兼容性 否 1-500 个字符，环境要求（如果需要） 元数据 否 为附加属性提供的键值对 允许的工具 否 预批准工具的空格分隔列表（实验）
描述最佳实践 关键：描述是自动技能发现的主要机制。包括： 它的功能（功能） 何时使用（触发器、场景、文件类型） 用户在提示中可能提到的关键字 良好的示例：描述：'使用Playwright测试本地Web应用程序的工具包。使用时要求验证前端功能、调试UI行为、捕获浏览器截图或查看浏览器控制台日志。支持Chrome、Firefox和WebKit。' 糟糕的示例：描述：'Web测试助手'
步骤 3：编写技能正文 在前置内容之后，添加Markdown说明。推荐部分： 部分 目的 # 标题 简要概述
何时使用此技能 强化描述触发器
先决条件 所需工具、依赖项
步骤指南 任务的编号步骤
故障排除 常见问题和解决方案
参考资料 链接到捆绑文档
步骤 4：添加可选目录（如果需要） 文件夹 目的 何时使用 scripts/ 可执行代码（Python、Bash、JS） 执行操作的自动化 references/ 代理读取的API参考、模式、指南 assets/ 静态文件，按原样使用 图像、字体、模板 templates/ 代理修改的启动代码 扩展的脚手架
示例：完整的技能结构 my-awesome-skill/ ├── SKILL.md # 必需的说明 ├── LICENSE.txt # 可选的许可证文件 ├── scripts/ │ └── helper.py # 可执行的自动化 ├── references/ │ ├── api-reference.md # 详细文档 │ └── examples.md # 使用示例 ├── assets/ │ └── diagram.png # 静态资源 └── templates/ └── starter.ts # 代码脚手架
快速入门：复制此模板 复制make-skill-template/文件夹 将其重命名为您的技能名称（小写、连字符） 更新SKILL.md：更改名称以匹配文件夹名称 编写一个关键字丰富的描述：用您的说明替换正文内容 根据需要添加捆绑资源 使用npm run skill：validate进行验证
验证检查清单 文件夹名称为小写、连字符 名称字段与文件夹名称完全匹配 描述为10-1024个字符 描述解释了它的功能和何时使用 描述用单引号括起来 正文内容少于500行 捆绑的资产每个少于5MB 故障排除 问题 解决方案 技能未发现 改进描述以包含更多关键字和触发器 验证失败，名称不正确 确保小写、无连续连字符、与文件夹名称匹配 描述太短 添加功能、触发器和关键字 资产未找到 使用从技能根目录开始的相对路径
参考 Agent Skills官方规范：https://agentskills.io/specification