qiaomu-skill-publisher：让 Skill 发布和安装验证真正闭环

写过 Skill 的同学，一定懂这个痛——

本地跑通了，兴冲冲想发到 GitHub，结果 README 还是「特性 1」「TODO 占位符」，仓库名和 Skill 名对不上，frontmatter YAML 报一堆错……最离谱的是，自己装没问题，别人 npx skills add 就是找不到。

qiaomu-skill-publisher 就是来解决这个的。一个 Python 脚本，把 Skill 发布到 GitHub 的全流程打包好，还带真实安装验证。

它到底做了什么

安装就一行：

npx skills add joeseesun/qiaomu-skill-publisher

装完之后，只要告诉它你的 Skill 目录，它会按顺序跑这些检查：

第一步，YAML 校验。用 PyYAML 严格解析 SKILL.md 的 frontmatter，name 和 description 有一个写错格式就报错，不会让你带着病提交。

第二步，README 质量扫描。会自动扫一遍 README 里有没有 TODO、特性 1、[问题 1] 这种还没替换的占位符——这些都是导致别人看了一眼就不想装的重灾区。

第三步，仓库名安全检查。Skill 名和 GitHub 仓库名是两回事，脚本会优先读取当前 git remote，避免把更新推到别人的仓库里去。

第四步，真实安装验证。这是它最实用的地方——先跑 npx skills add <user>/<repo> --list 确认能被平台发现，然后在临时目录真实装一次，确认 SKILL.md 真的落盘了，而不是只存在于列表里。

第五步，自动同步本地目录。发布成功后，会把 Skill 同步到 ~/.agents/skills/<name>，不用自己手动拷贝。

什么场景用它

刚写完一个 Skill，想公开分享：本地跑通了，发出去之前先用它过一遍检查，比被人 issue 反馈「装不了」体面多了。

维护多个 Skill，每次发布都要走一遍流程：配合 cron 或者 GitHub Actions，可以把「修 bug → 提交 → 发布 → 验证」串成自动化流水线，睡一觉醒来各个平台都更新完毕。

想 fork 别人的 Skill 做二次开发：先 publisher 验证它能装，再 fork，避免踩完坑才发现原始仓库本身就有问题。

开发者视角的亮点

作者是向阳乔木，做 Skill 生态工具的老手了。这个 publisher 本身也遵循 Skill 标准，SKILL.md、manifest.json、scripts 目录结构都很规范。它的核心价值不是「帮你推送到 GitHub」——这是 git push 就能解决的事——而是把「发布」和「验证」这两件事真正闭环，让 Skill 从「我的本地玩具」变成「别人真的能安装使用的工具」。

Star 34，不算多，但对于 Skill 发布这个细分场景，已经算是社区认可了。

快速上手

# 先检查，不发布
python3 ~/.agents/skills/qiaomu-skill-publisher/scripts/publish_skill.py ~/.agents/skills/my-skill --dry-run

# 正式发布
python3 ~/.agents/skills/qiaomu-skill-publisher/scripts/publish_skill.py ~/.agents/skills/my-skill

发布后别人安装：npx skills add joeseesun/my-skill

GitHub：https://github.com/joeseesun/qiaomu-skill-publisher

GitHub: https://github.com/joeseesun/qiaomu-skill-publisher