SuperAPI AI 工具集

make-skill-template

智能体与模型

查看项目

更新于 10-15 21:38

技能介绍

用途:这是一个用于创建新 Agent Skills 的元技能,帮助搭建技能文件夹、生成 SKILL.md,并说明 Agent Skills 规范。适用于用户要求“create a skill”“make a new skill”“scaffold a skill”,或想为 GitHub Copilot 添加专用能力、需要组织带资源包的技能、或复制该模板作为起点时。

主要能力:创建小写连字符命名的技能目录;生成带 YAML frontmatter 的 SKILL.md;说明 frontmatter 字段要求(name 必填,1-64 字符,仅小写字母、数字、连字符,须与文件夹名一致;description 必填,1-1024 字符,须说明做什么和何时使用;license、compatibility、metadata、allowed-tools 可选);提供描述编写最佳实践,强调 description 是自动发现技能的主要机制,应包含能力、触发场景和关键词;给出技能正文推荐章节(标题、何时使用、前置条件、分步工作流、故障排查、参考);说明可选目录 scripts/、references/、assets/、templates/ 的用途。

使用方式:先创建 skills/<skill-name>/ 目录,再生成 SKILL.md 并写入 frontmatter,然后编写正文,按需添加可选目录。也可直接复制 make-skill-template/ 文件夹,重命名为技能名,更新 name 与 description,替换正文。

限制与校验:文件夹名须小写连字符;name 须与文件夹名完全一致;description 建议 10-1024 字符并用单引号包裹;正文建议 500 行以内;每个打包资源建议小于 5MB;资源引用使用相对技能根目录的路径。若技能未被发现,应改进 description 的关键词与触发条件。官方规范见 https://agentskills.io/specification。