Qiaomu Skill Publisher

skill-publisher

一键发布 Claude Code Skill 到 GitHub，自动验证、补全文件、创建仓库、推送并验证可安装。

安装

npx skills add joeseesun/skill-publisher

Skill Publisher

一键将 Claude Code Skill 发布到 GitHub，自动完成验证、补全、推送全流程。

前置条件

• gh CLI 已安装且已登录（gh auth status）
• Skill 目录包含有效的 SKILL.md（含 YAML frontmatter name + description）

发布流程

当用户要求发布 skill 时，运行发布脚本：

python3 ~/.claude/skills/skill-publisher/scripts/publish_skill.py 

确定 skill 目录

• 如果用户说"发布这个 skill"且当前在某个 skill 目录 → 用当前目录
• 如果用户指定了 skill 名称 → 在 ~/.claude/skills/ 下查找
• 如果不确定 → 问用户要发布哪个 skill

脚本自动完成的步骤

1. 验证 SKILL.md 的 YAML frontmatter（name + description）
2. 检查 gh CLI 就绪状态
3. 创建 LICENSE（MIT，如果缺少）
4. 生成 README.md（从 SKILL.md 提取，如果缺少）
5. 初始化 git（如果需要）
6. 创建 GitHub 公开仓库并推送
7. 验证 npx skills add 可发现

参数选项

参数	说明
--private	创建私有仓库（默认公开）
--dry-run	仅检查，不实际发布
--skip-verify	跳过 npx skills 验证
--github-user USER	指定 GitHub 用户名（默认自动获取）

更新已发布的 skill

对已有 GitHub 仓库的 skill 再次运行同一命令，脚本会检测到仓库已存在，自动 commit + push 更新。

使用示例

用户：发布 yt-search-download 这个 skill
执行：python3 ~/.claude/skills/skill-publisher/scripts/publish_skill.py ~/.claude/skills/yt-search-download

用户：把当前 skill 发到 GitHub
执行：python3 ~/.claude/skills/skill-publisher/scripts/publish_skill.py .

用户：先检查一下能不能发布
执行：python3 ~/.claude/skills/skill-publisher/scripts/publish_skill.py  --dry-run

发布完成后

向用户展示：

• GitHub 仓库 URL
• 安装命令：npx skills add /
• 验证结果

License

MIT

📱 关注作者

如果这个项目对你有帮助，欢迎关注我获取更多技术分享：

• X (Twitter): @vista8
• 微信公众号「向阳乔木推荐看」: