用途:把本仓库部署到 skills.sh 生态。资料说明该生态没有发布 API,所谓部署等于“公开可安装的仓库 + 首次安装以写入目录遥测”。该技能把这一流程固定下来,避免临时操作。仅通过斜杠命令调用,因为会切换仓库可见性,而这一操作在社交层面难以撤销(任何曾推送过的内容都会公开)。
不适用场景:编写或修复技能应使用 add-skill;skills/ 下没有任何技能时应先构建,绝不发布空目录;对已公开仓库的日常推送用普通 git 即可。
工作流:先做硬性预检,任一失败即停止——工作区必须干净且由所有者推送完成,该技能从不执行 git commit 或 git push;有未提交改动时停止并把清单交给所有者。预检命令包括 git status --porcelain(须为空)、make check(须以 0 error(s) 结束)、npx skills add . --list(发现 skills/ 下全部技能)、gh skill publish --dry-run(规范校验,需 gh >= 2.90,公开预览)、python3 -c "import json; json.load(open('skills.sh.json'))"。需逐条处理 gh skill 警告:补上缺失的 license: MIT frontmatter;.claude/skills/ 警告在此属预期(随仓库提交的一方开发技能,非第三方内容)。同时核对 README 目录、CHANGELOG 是否最新、每个技能描述是否以收益为导向(即列表文案)、最新提交 CI 是否通过。
人工阻塞项需用户明确确认,不得假设:全历史密钥扫描(gitleaks/trufflehog)已完成;个人/私有文件审查已完成(曾提交的一切都会公开)。若 $ARGUMENTS 含 --dry-run,则到此为止并报告就绪状态。分组方面,确保 skills.sh.json 把每个技能恰好列入一个分组,每组配一句有吸引力的描述。
切换可见性(操作前立即与用户确认):gh repo edit <owner>/<repo> --visibility public --accept-visibility-change-consequences。保护措施(公开后可用):gh api repos/<owner>/<repo>/private-vulnerability-reporting --method PUT;添加默认分支规则集,单人维护默认只阻止强推和删除(require-PR 会挡住所有者直推),有外部贡献者时升级为 require-PR + code-owner 审查 + validate 检查;再对 v* 加标签规则集(阻止更新与删除),使已发布版本不可变。
发布:切出与 .claude-plugin/plugin.json 匹配的版本化 GitHub release:gh skill publish --tag v<version>,它会重新校验、缺失时添加 agent-skills 主题并生成发布说明;再添加 skills-sh 主题:gh repo edit <owner>/<repo> --add-topic skills-sh。以消费者方式验证并播种目录(本地运行,不要在 CI 中运行,CI 会禁用遥测,首次真实安装才会列出仓库):npx skills add <owner>/<repo> --list;mkdir -p /tmp/skills-verify && cd /tmp/skills-verify;npx skills add <owner>/<repo> --skill '*' -a claude-code -y;npx skills list -a claude-code。收尾:README 带 skills.sh 徽章、设置 homepage、提醒手动上传社交预览图。报告仓库 URL、skills.sh 页面 URL、安装命令、发布标签、已应用保护、跳过项及解锁条件,并说明 skills.sh 页面在遥测处理播种安装后才出现(页面有缓存)。
限制与注意:可见性切换是历史的不可逆点,故需显式确认;npx skills add . --list 报 “No skills found” 说明 frontmatter 或目录结构有问题,应据 make check 输出修复而非盲目重构;排行榜/仓库页面滞后于播种安装属正常;单人直推 main 的仓库不要启用 require-PR 规则集。