用途:将本地技能发布到 GitHub,使其可通过 npx skills add <org>/<repo> 被发现和安装。
发现机制:npx skills CLI 从 GitHub 仓库中按 <repo>/skills/<skill-name>/SKILL.md 的结构发现技能,用户用 npx skills add <org>/<repo> 安装。
主要能力与流程:
- 收集信息:通过 AskUserQuestion 获取要发布的本地技能目录(须含 SKILL.md)、GitHub 组织或用户名、仓库名(如 agent-skills、my-skills)。
- 校验技能:确认 SKILL.md 存在且 YAML frontmatter 含 name 与 description;建议 SKILL.md 少于 200 行;确认 references/、scripts/、assets/ 等目录已包含。
- 发布到 GitHub:使用 gh 命令,先 gh repo view <org>/<repo> 检查仓库是否存在,不存在则 gh repo create <org>/<repo> --public --description "Agent skills collection",再 gh repo clone <org>/<repo> /tmp/skills-publish-<repo>,用 mkdir -p 创建 skills/<skill-name> 目录,复制技能文件,最后 git add .、git commit -m "Add <skill-name> skill"、git push origin main。
- 验证发布:运行 npx skills add <org>/<repo> --list 确认可被发现。
适用场景:需要把个人或团队的技能公开分享、上传到 GitHub 供他人通过 npx skills 安装时。
限制与注意:技能仓库需为公开仓库才能被技能发现;目录中的技能名应与 SKILL.md frontmatter 中的 name 一致;一个仓库的 skills/ 目录可包含多个技能;建议在仓库根目录添加 README.md 说明技能集合。具体收费、平台支持范围等资料暂未提供。