skill-publisher

AI Agent Skill一键规范发布与安装验证工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:skill-publisher。
它的用途是:AI Agent Skill一键规范发布与安装验证工具
完整的 Skill 内容见:https://321skill.com/skills/skill-publisher/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“先检查这个本地Skill能不能正常发布”,它会自动校验SKILL.md格式、README占位符等问题,输出检查报告不执行实际发布。

对AI说:“把这个Skill发布到GitHub并验证可安装”,它会自动创建公开仓库、推送代码、执行真实安装校验,最后输出仓库地址和用户安装命令。

介绍

很多开发者将工作流沉淀为可复用的AI Agent Skill后,常卡在发布环节:README写得像内部文档、SKILL.md的YAML格式有误、推错GitHub仓库、发布后用户无法正常安装,还要处理不同Agent的入口冲突,手动操作繁琐且容易踩坑。它将Skill发布全流程封装为自动化可验证脚本,会先校验SKILL.md的元数据与YAML格式合法性,检查README是否残留未替换的占位内容,自动识别本地Git仓库信息,创建MIT协议与GitHub公开仓库,最后在临时目录真实执行安装命令验证可用性,还支持预检查模式。它适合所有需要将本地AI Agent Skill公开分享、供其他用户安装使用的开发者,尤其是经常产出复用型Skill、需要频繁发布更新的效率工具创作者。使用前请确保已安装并登录GitHub CLI,本地配有Python3.9+与Node.js环境,发布前务必检查README中没有密钥、私有路径、账号信息等敏感内容,若Skill名与仓库名不一致可通过参数指定。

核心特点

和普通的Git推送类脚本不同,它内置产品级README规范校验,还会在隔离临时目录真实执行npx安装命令,100%验证发布后的Skill可被用户正常检索安装。

注意事项

仅支持发布到GitHub仓库,依赖本地预装的GitHub CLI、Python3.9+与Node.js环境,无法适配Gitee等其他代码托管平台。

常见问题

如何在不实际发布的情况下检查Skill是否符合发布要求?

运行发布脚本时添加--dry-run参数,即可仅执行全量校验不触发发布操作。

Skill名称和要发布的GitHub仓库名不一致怎么处理?

运行脚本时通过--repo-name参数指定目标GitHub仓库名即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/skill-publisher/raw/index.md 读取 skill-publisher 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。