用途:帮助创建、校验和管理遵循 agentskills.io 规范的 Agent Skills。当用户要求新建技能、修改或改进已有技能、校验技能结构或 frontmatter、提到 skill/agent skill/agentskills.io,或想了解 Agent Skills 格式时使用。
主要能力:Agent Skills 是轻量开放格式,用专门知识与工作流扩展 AI 智能体能力。核心是一个包含 SKILL.md 的文件夹,采用渐进式披露:启动时只加载 name 与 description,相关时读取完整 SKILL.md,需要时再加载引用文件或执行代码。目录结构为 skill-name/ 下含必需的 SKILL.md,以及可选的 scripts/、references/、assets/。
SKILL.md 格式:YAML frontmatter 加 Markdown 正文。必填字段 name(1-64 字符,仅小写字母、数字、连字符,不能以连字符开头或结尾,不能有连续连字符,须与父目录同名)和 description(1-1024 字符,说明做什么及何时使用)。可选字段 license、compatibility(1-500 字符)、metadata(字符串键值对)、allowed-tools(空格分隔的预批准工具,实验性)。正文建议包含何时使用、能力概述、分步说明、示例、常见模式、最佳实践、边界情况;主 SKILL.md 建议少于 500 行。
使用方式:按步骤收集需求、命名、写描述、创建目录、编写 SKILL.md、添加支持文件并校验。创建目录示例:mkdir -p skill-name/scripts;mkdir -p skill-name/references;mkdir -p skill-name/assets。若已安装 skills-ref 库,可运行 skills-ref validate ./skill-name 校验,或 skills-ref to-prompt ./skill-name 生成提示词 XML。文件引用使用相对路径,且保持一层深度。
适用场景:为基于文件系统或基于工具的智能体编写技能,涵盖基础指令型、带脚本型、带引用文档的复杂型技能。
限制:allowed-tools 为实验特性,支持情况不一;技能需与文件系统型或工具型智能体配合,工具实现由开发者负责;含脚本时需注意安全,警告危险操作、记录依赖、考虑沙箱与白名单、避免硬编码凭据。具体收费、价格、平台与效果资料暂未提供。