SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:skill-creator 面向想要创建或更新技能(skill)的用户,提供一套创建有效技能的流程与规范指导,基于 TypeScript/Bun 脚本,并声明 Windows 兼容。

主要能力与规范要点:技能是模块化的独立包,用来扩展 Claude 的能力,提供专门的知识、工作流与工具,可由脚本、参考文档与资产组成。每个技能必须包含 SKILL.md,其 YAML frontmatter 必须有 name 和 description 两个字段,Claude 仅读取这两个字段来判断何时使用该技能;正文为 Markdown 指令,仅在技能触发后加载。可选目录包括 scripts/(可执行代码,如 TypeScript、Bash)、references/(按需加载的文档)、assets/(用于输出产物的模板、图标、字体等文件)。

设计原则:强调精简,避免冗余说明;按任务脆弱性与可变性设置自由度(高自由度用于多种可行路径,低自由度用于易错且需固定顺序的操作)。采用三级加载的渐进式披露:元数据常驻上下文、SKILL.md 正文在触发时加载(建议 500 行以内)、捆绑资源按需加载。引用应保持一级层级,长引用文件加目录。不要在技能中加入 README、安装指南、变更日志等多余文档。

创建流程:1)用具体示例理解技能用途与触发方式;2)规划可复用内容(脚本、参考、资产);3)运行 bun scripts/init-skill.ts <skill-name> --path <output-directory> 初始化技能目录与模板;4)编辑技能,先实现可复用资源,脚本需实际运行测试;5)运行 bun scripts/package-skill.ts <path/to/skill-folder> 打包,可选指定输出目录,打包会先自动校验;6)根据真实使用迭代。

适用场景:为特定领域或多步骤任务构建专用技能,组织公司专属知识、schema 与业务逻辑,封装文件格式或 API 集成说明,以及需要重复执行且要求确定性的脚本任务。

限制:资料未提供价格、收费、平台范围(除 Windows 兼容声明外)与效果保证;具体脚本实现细节、最新版本信息及许可条款暂未提供。