SuperAPI AI 工具集

create-skill

智能体与模型

查看项目

更新于 10-15 20:07

技能介绍

用途:引导创建 Claude Code Skill,或改进已有 Skill,适用于技能创建、技能修改、编写 SKILL.md、新建技能、技能改进与更新等请求。

主要能力:基于渐进式披露(Progressive Disclosure)三阶段组织信息。第一阶段 Discovery 放在 frontmatter 的 name 和 description,约 100 token;第二阶段 Activation 为核心指令与使用方法,写入 SKILL.md 正文,少于 5000 token、不超过 500 行;第三阶段 Execution 为详细文档、脚本与资源,放在 references/、scripts/、assets/,按需加载。原则是仅凭第一阶段可判断是否需要该技能,仅凭第二阶段即可执行任务,第三阶段才按需读取。

目录结构:skill-name/ 下含 SKILL.md(必需,第二阶段),references/ 存详细文档,scripts/ 存可执行代码,assets/ 存模板与配置等静态资源。

使用方式:创建目录,例如 mkdir -p skills/{name}/references,按需追加 scripts、assets;编写 frontmatter,name 为技能标识,1-64 字符,仅小写字母、数字与连字符,且与目录名一致;description 为 1-1024 字符,写明做什么与何时使用,包含触发关键词;正文保持精简,结构为标题、概述、使用方法、详细信息的引用链接。文件引用需用相对路径,且只引用一层深度(如 references/file.md 可以,references/sub/file.md 不可以),使用 Markdown 链接。

可选字段:argument-hint(参数提示)、disable-model-invocation(仅用户可调用,适合有副作用的操作)、user-invocable(仅 Claude 可调用,适合内部知识)、context: fork(子代理隔离执行)、agent(子代理类型)、allowed-tools(工具限制)。使用模式包括一般技能、用户专用、Claude 专用、隔离执行。

验证要点:name 长度与字符合规、与目录名一致、description 写明做什么与何时、SKILL.md 不超过 500 行、正文只留核心而将细节分离到 references/、文件引用为相对路径且一层深度。

限制:资料未提供价格、计费方式、平台支持范围与效果保证等信息。