Skill 创建发布助手

它解决什么问题

当你想让 Claude、Cursor、Windsurf 这些智能体替你完成一项具体任务时，通常需要手写一个 Skill：在 SKILL.md 里描述能力、在 skill.json 里注册元信息、还要保证目录结构扁平、关键词能被触发器命中。手动做一遍并不复杂，但要做对就有不少琐碎约束——比如不能硬编码绝对路径、必须同时提供 skill.json 和 marketplace.json、README 里要列出各 IDE 的安装目录。这些约束散落在文档各处，很容易遗漏。

skill-creator-publish 把这件事变成一条工作流：你描述需求，它生成骨架、填好字段、创建 GitHub 仓库并推送，最后 clone 回来验证文件完整性。

核心能力

这个技能的工作分为四步：

1. 确认需求——向你要 Skill 名称、功能描述、5–10 个触发关键词、是否需要 Python 脚本、以及目标 GitHub 账号。
2. 生成骨架——在仓库根目录创建扁平结构：SKILL.md、skill.json、marketplace.json、scripts/ 目录和 README.md。README 固定包含项目简介、各 IDE 安装路径表、使用方法和许可证等章节。
3. 发布到 GitHub——通过 gh CLI 创建仓库、提交并推送。如果 gh repo create 因权限失败，会切换到 API 方式。
4. 发布后验证——clone 仓库回来检查文件是否完整、有没有残留硬编码路径、前后元数据是否一致。

几个关键细节值得注意：SKILL.md 的 frontmatter 里 keywords 是必填的，直接影响触发命中率；alwaysApply 设为 false，让 Skill 按需激活而不是常驻占用上下文；默认使用 MIT 许可证。

适用边界

首先，发布前需要确认 GitHub 认证已就位。你必须提前执行过 gh auth login，或提供有效的 Token。该 Token 需要 Classic 权限（repo scope），Fine-grained Token 目前无法用于仓库创建。

其次，这个技能只支持 GitHub，不支持 Gitee 或其他平台。仓库结构和文件命名需要遵循 Skill 的约定——根目录放 SKILL.md 和 scripts/，不要嵌套进 plugins/ 子目录，否则智能体 clone 后可能无法正确加载。

最后，生成的 README 里会有各 IDE 的 Skill 目录对照表（如 .claude/skills/、.cursor/skills/），这是为了让不同编辑器的用户都能直接把仓库里的文件拷到对应位置，而不是依赖某种统一的安装机制。