SuperAPI AI 工具集

creating-agent-skills

智能体与模型

查看项目

更新于 10-16 09:51

技能介绍

用途:帮助为 Codex CLI、GitHub Copilot、Amp 创建可移植的 Agent Skills 包,采用统一 SKILL.md 格式,一次编写可跨工具使用。

主要能力:提供 agentskills.io 规范,说明必需与可选 frontmatter 字段。必需字段为 name(1-64 字符,小写字母数字加连字符,须与父目录同名)和 description(1-1024 字符,须同时写明功能与使用场景);可选字段包括 license、compatibility、allowed-tools、metadata。还规定目录结构:SKILL.md 必需,scripts/、references/、assets/ 可选。

使用方式:按工具放置文件——Codex CLI 与 Amp 用 .agents/skills/{skill-name}/SKILL.md,GitHub Copilot 用 .github/skills/{skill-name}/SKILL.md。技能采用渐进式加载,元数据约 100 tokens 启动加载,激活时加载完整 SKILL.md,支持文件按需引用,建议 SKILL.md 保持在 500 行以内。可用校验命令:skills-ref validate ./my-skill。跨工具迁移只需移动目录,例如 mv .agents/skills/my-skill .github/skills/my-skill,内容无需改动。

适用场景:为上述工具编写可复用 AI 智能体技能包,或需要统一描述格式与目录约定时使用。

限制:allowed-tools 为实验性;正文格式无强制限制但建议分区;资料未提供具体收费标准、平台支持范围之外的细节。