SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:这是一个用于创建有效技能的指南型技能。当用户想要新建或更新一个扩展 Claude 能力的技能时使用它。

主要能力: 技能是模块化、自包含的包,通过专门知识、工作流和工具扩展 Claude 的能力,好比特定领域的“上手指南”。技能可提供专门工作流、工具集成说明、领域专长以及打包好的资源。

核心设计原则:

  • 简明为先:上下文窗口是公共资源,只补充 Claude 尚不具备的信息,优先使用简洁示例而非冗长解释。
  • 设置合适的自由度:多种做法均可时用文本指令(高自由度);存在首选模式时用伪代码或带参数脚本(中自由度);操作脆弱、需严格一致时用特定脚本(低自由度)。

技能结构:每个技能包含必需的 SKILL.md 与可选的打包资源。SKILL.md 由 YAML frontmatter(name、description 必需,compatibility 可选)和 Markdown 正文组成,name 与 description 是 Claude 判断何时触发技能的主要依据。可选资源包括 scripts/(可执行代码)、references/(按需加载的文档)、assets/(用于产出的模板、图标、字体等)。技能不应包含 README.md、安装指南、更新日志等多余文档。

渐进式披露:三层加载——元数据(name+description,始终在上下文)、SKILL.md 正文(触发时加载,建议少于 500 行)、打包资源(按需使用)。大文件(超过 1 万词)应在 SKILL.md 中提供 grep 搜索模式;引用层级保持一层深;超过 100 行的引用文件应加目录。

创建流程:

  1. 用具体示例理解技能用途及其触发方式。
  2. 规划可复用内容(scripts、references、assets)。
  3. 初始化:运行 scripts/init_skill.py <skill-name> --path <output-directory>,生成模板目录。
  4. 编辑技能:先实现可复用资源,新增脚本需实际运行测试,删除不需要的示例文件,再更新 SKILL.md(使用祈使句,将“何时使用”写入 description 而非正文)。
  5. 打包:运行 scripts/package_skill.py <path/to/skill-folder>(可选指定输出目录),打包前会自动校验。
  6. 根据真实使用情况迭代。

限制:资料未提供具体的收费、价格或平台支持信息;创建步骤中的部分脚本参数及打包说明在资料末尾被截断,未完整提供。