SuperAPI AI 工具集

skills-visibility

编程与开发

查看项目

更新于 10-15 22:19

技能介绍

用途:把多个 agent skill(SKILL.md 文件)发布成可被 AI 编程代理发现和安装的目录,类似 llms.txt 之于网页。机制是在自有域名根路径提供 .well-known/agent-skills/index.json 发现索引,主流安装器(npx skills、gh skill、Claude 插件市场)据此解析技能。

主要能力与流程:1)每个技能放在 Git 仓库的 skills/<name>/SKILL.md;2)区分三种形态:单文件(仅 SKILL.md)、多文件(SKILL.md 加脚本/文档/模板)、bundle(一个仓库发布多个技能);3)从自有域名提供文件并计算摘要,不要指向 raw.githubusercontent.com,否则字节与摘要会漂移导致安装失败;4)构建归档:单文件直接提供 SKILL.md,多文件提供扁平 <name>.tar.gz(SKILL.md 在归档根,无外层目录),bundle 提供合并 tar.gz,每个技能为独立 <name>/ 目录;5)写发现索引,仅含 $schema 和 skills 两个顶层键,每个技能含 name、description、type(skill-md 或 archive)、url、digest(sha256:<hex>);6)提供多种安装命令:npx skills add https://yourdomain.com --skill <name> -a <agent> -g、claude plugin marketplace add <owner>/<repo> 与 claude plugin install <name>@<marketplace>、gh skill install <owner>/<repo> <name>、以及 curl 方式;7)可选埋点统计安装;8)验证索引 content-type、JSON 有效性、摘要匹配、tar 根目录结构及实际安装。

限制与注意:npx skills 的源参数必须是带 scheme 的裸 origin(如 https://yourdomain.com),不能带路径;摘要必须可复现,归档需固定模式、排序、mtime 并用 gzip -n;bundle 不单独建索引条目,每个成员技能各自列出;不要添加 schema 未定义的字段;缺少摘要会静默安装损坏内容。资料未提供具体收费、价格或平台支持范围。