SuperAPI AI 工具集

skill-builder

智能体与模型

查看项目

更新于 10-16 06:22

技能介绍

用途:Skill Builder 帮助作者编写 Agent Skills——即教智能体掌握某项专门能力的 SKILL.md 指令包,并对其进行校验与打包以便分发。适用场景包括“创建一个做 X 的技能”“我的技能没有被触发/改进它的 description”“把这个技能文件夹打包以便他人安装”。

技能结构:一个技能是 kebab-case 命名的文件夹,内含必需的 SKILL.md,以及可选的 scripts/、references/、templates/ 或 assets/。SKILL.md 以 YAML frontmatter 开头,包含 name(kebab-case,与文件夹名一致)、description(说明做什么以及何时使用,是触发信号)、license 等字段,其后是给智能体的指令正文。

编写可触发的 description:description 决定智能体是否加载该技能,需同时包含两半——技能做什么(能力、文件类型、动词)以及何时使用(用户可能说出的具体触发短语,如 convert to markdown、merge PDFs、build an MCP server)。应填入真实关键词,避免模糊表述;正文保持聚焦,把长参考资料放入 references/,使其仅在需要时加载。

校验:先安装依赖 pip install pyyaml,再运行 python scripts/validate_skill.py path/to/my-skill。校验会检查 frontmatter 是否为合法 YAML、name/description 是否存在、name 是否为 kebab-case 且与文件夹匹配、正文是否非空。

打包:运行 python scripts/package_skill.py path/to/my-skill -o my-skill.skill。该命令先校验,再生成可安装的 .skill 归档,解包后为 my-skill/...。

提示:一个技能对应一项连贯能力,不相关的任务应拆分为多个技能;优先捆绑小脚本而非每次重新推导相同逻辑;用用户实际使用的措辞测试 description 能否触发,并确认不会对无关请求误触发。

限制:资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。