使用 gh skill 管理 Skills

gh skill 属于 GitHub CLI，不是 copilot 命令或 Copilot CLI 的 /skills。当前为 public preview，需要 GitHub CLI 2.90.0 或更高版本。

搜索与预览

gh skill search TOPIC
gh skill preview OWNER/REPOSITORY SKILL

preview 在终端展示 SKILL.md 和文件树，不安装文件。GitHub 不验证第三方 Skill 的安全性，采用前应检查其说明、隐藏指令和脚本。

安装与作用范围

gh skill install
gh skill install OWNER/REPOSITORY
gh skill install OWNER/REPOSITORY SKILL

无参数是交互流程；仅指定仓库时可以交互选择其中的 Skill；同时指定名称时直接安装该 Skill。默认目标是 Copilot，作用范围是 project，工具会按 agent host 选择目录。

可用 --agent 和 --scope 明确目的地。官方示例：

gh skill install github/awesome-copilot documentation-writer --agent claude-code --scope user

这是安装到本地指定客户端的操作，不自动把个人 Skill 同步到 GitHub cloud agent。云端项目目录见云端 Skills。

选择版本与固定更新

指定 tag 或 SHA：

gh skill install github/awesome-copilot documentation-writer@v1.2.0

若要固定版本、后续更新时跳过它，使用：

gh skill install github/awesome-copilot documentation-writer --pin v1.2.0

@VERSION 与 --pin 互斥，不能同时提供。示例中的 tag 仅展示官方命令格式，安装具体 Skill 前应核对其仓库实际存在的版本。

更新

安装时会把来源仓库、ref 和 tree SHA 等 provenance 信息写进 SKILL.md frontmatter，供更新检查使用。

gh skill update
gh skill update SKILL
gh skill update --all

默认交互检查；指定名称更新单个 Skill；--all 不经逐项提示更新全部已安装 Skill。Pinned Skill 会跳过，需要更换版本时用新的 --pin 值重新安装。

验证与发布

gh skill publish --dry-run
gh skill publish --fix
gh skill publish

--dry-run 验证 Agent Skills 规范及远程设置，例如 tag protection、secret scanning 和 code scanning，不发布。--fix 自动修改元数据问题，也不发布，但会改变本地文件。无这些选项的 publish 执行验证与发布。

完整子命令可用 gh skill --help 查看。