技能发布器

📌 Skill基础信息

• Skill名称: skill-publisher
• 简称: 无
• 来源: 社区第三方 (joeseesun)
• 运行宿主: 通用 Agent 工具环境（依赖 npx skills 生态）
• 核心定位: 一键自动化发布 AI Agent Skill 到 GitHub，完成从本地验证到云端部署的全流程，适合技能开发者快速分享和分发技能。

🧩 内部核心组成

该 Skill 主要基于一个 Python 脚本实现核心发布逻辑，无子 Agent 或复杂命令结构。

核心组件:

• publish_skill.py: 主发布脚本，包含完整的验证、生成、推送逻辑
• YAML 解析器: 用于校验 SKILL.md 的 frontmatter 格式
• GitHub CLI 集成: 依赖 gh 命令行工具进行仓库操作

目录结构:

~/.agents/skills/qiaomu-skill-publisher/
└── scripts/
    └── publish_skill.py

🛠 安装与启用方式

前置依赖:

1. 已安装并登录 GitHub CLI: gh auth login
2. 有效的 SKILL.md 文件（包含 name 和 description 的 YAML frontmatter）

安装命令:

skills install --user joeseesun/qiaomu-skill-publisher

启用方式:

通过自然语言触发：

• "发布这个skill"
• "publish skill"
• "把skill发到GitHub"
• "分享这个skill"
• "/publish-skill"

📋 标准工作流

1. 触发识别: 用户通过自然语言指令请求发布技能
2. 目录定位:

- 明确指定技能名 → 在 ~/.agents/skills/ 下查找

- 当前目录为技能目录 → 使用当前目录

- 不明确时 → 询问用户确认

1. 自动化发布流程:

- 验证 SKILL.md 的 YAML frontmatter 格式

- 检查 gh CLI 认证状态

- 自动生成或校验 README.md（拦截占位符内容）

- 创建 MIT LICENSE（如缺失）

- 识别或指定 GitHub 仓库名称

- 初始化 git 并创建/更新 GitHub 仓库

- 推送代码并验证可通过 npx skills 安装

1. 结果反馈: 向用户展示仓库 URL 和安装命令

⚠️ 关键限制、缺陷、注意事项

平台限制:

• 必须使用 GitHub 作为托管平台
• 依赖 gh CLI 工具，仅支持已安装该工具的环境

Token 消耗:

• 主要消耗 GitHub API 调用额度
• 大型技能库可能消耗较多上传带宽

适用项目:

• 已完成开发的 Agent Skill
• 具备完整 SKILL.md 文档的技能
• 希望公开分享的技能项目

不适用项目:

• 私有或企业内部技能
• 文档不完整的技能原型
• 仅本地使用的临时技能

已知坑点:

• SKILL.md 中 description 字段包含引号或冒号会导致 YAML 解析失败
• README 中存在 TODO 等占位内容会导致发布失败
• 技能名称与仓库名称不一致时需要手动指定 --repo-name

生产环境适用性:

• ✅ 可用于生产环境发布
• 建议先在测试仓库进行 --dry-run 验证

✅ 适用场景 & ❌ 不适合场景

适用场景:

• Agent Skill 开发者需要快速发布和分享技能
• 希望自动化技能发布流程，减少手动操作
• 需要确保技能符合 npx skills 生态标准
• 想要多工具共享的技能分发需求

不适合场景:

• 私有技能或企业内部技能分发
• 技能仍处于原型开发阶段
• 不需要 GitHub 托管的分发场景
• 无法满足 README 质量要求的技能项目

skills install --user joeseesun/qiaomu-skill-publisher