用途:该技能为智能体提供创建、安装与更新技能的操作指南。技能是模块化的自包含包,用来扩展智能体能力,提供专门知识、工作流与工具。
主要能力:安装技能时,从 URL(单文件用 curl 或 web_fetch;压缩包下载解压到临时目录)、本地文件或本地压缩包获取内容,定位 SKILL.md,从 YAML frontmatter 提取名称,再将整个技能目录复制到 <workspace>/skills/<name>/;若存在安装说明文件,按其步骤执行,但最终仍须落到该目录。从零创建时,按理解用例、规划资源、运行 init_skill.py 初始化、编辑 SKILL.md 与资源、可选运行 quick_validate.py 校验、按真实使用迭代的流程进行。
结构:每个技能必须有 SKILL.md,含 name 与 description 的 YAML frontmatter,以及 Markdown 正文;可选 scripts/(可执行代码)、references/(按需载入的文档)、assets/(输出用模板等)。description 是主要触发机制,需说明做什么与何时使用,且所有“何时使用”信息都放此处,不放正文。正文用祈使句形式编写。绝大多数技能应把内容集中在 SKILL.md,仅当文档超过 500 行才拆分 references;不要创建 README、INSTALLATION_GUIDE、CHANGELOG、API_REFERENCE、USAGE_EXAMPLES 等辅助文档文件。
命名:仅用小写字母、数字和连字符,长度小于 64 字符,优先动词开头的短语,目录名与技能名一致;可由工具前缀命名空间。
用法示例:scripts/init_skill.py my-skill --path <workspace>/skills;可加 --resources scripts,references,assets 与 --examples。脚本应实际运行测试;优先用 bash + curl、grep、sed、awk,减少依赖。API 密钥可在 metadata.requires 中用 env(单个)、anyEnv(多个备选)、bins、anyBins 声明;缺失时技能自动禁用。
限制:资料未提供收费、价格、平台支持范围等信息,欲知详情需见实际部署环境。