用途：把本地 agent skill 发布到 GitHub 并完成安装验证，也可用于更新已发布 skill。
主要能力：脚本会校验 SKILL.md 的 YAML frontmatter（name、description）、检查 gh CLI 就绪状态、缺少时创建 MIT LICENSE、生成或检查 README（拦截明显占位符）、识别并优先使用当前 origin 仓库名、初始化 git、创建或更新 GitHub 公开仓库并推送、验证 npx skills add --list 可发现，并在临时目录真实安装。发布成功后可将 skill 同步到 ~/.agents/skills/<name> 实体目录，供 OpenCode、Codex CLI、Cursor、Gemini CLI、GitHub Copilot、Amp、Cline、Warp 等读取。
用法：前置条件为 gh CLI 已安装并登录（gh auth status），skill 目录包含有效 SKILL.md。命令：python3 ~/.agents/skills/qiaomu-skill-publisher/scripts/publish_skill.py <skill_dir>。参数包括 --private、--dry-run、--skip-verify、--github-user、--repo-name、--no-symlink。更新时对已有仓库再运行同一命令即可 commit + push。
限制：未提供收费或价格信息；README 质量需人工把关，脚本不做完整功能验收；YAML 中带引号或冒号等特殊字符需改用块标量 |，否则 npx skills 严格解析可能报 No valid skills found。