# Github Skills Setup

> 连接 GitHub CLI、在新电脑安装/同步个人 Cursor Skills。 Use when the user asks to 连接 GitHub, login gh, 换电脑, 同步 skills, 安装 skills, bootstrap Cursor skills, or set up skills on another machine.

- Skill: `zhaozr815/github-skills-setup` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add zhaozr815/github-skills-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaozr815/github-skills-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhaozr815 (https://skillmd.com/u/zhaozr815)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zhaozr815/github-skills-setup

---


# GitHub + Skills 一键就绪

帮助用户在当前电脑完成：`gh` 登录 → 从 GitHub 拉取个人 Skills → 安装到 `~/.cursor/skills/`。

**事实**：同一 Cursor 账号不会自动同步个人 Skills；必须靠 GitHub（或手动拷贝）。

## 触发后立即执行

按顺序做，能自动的不要只口述：

1. 读 [manifest.md](manifest.md) 确认要安装的 skill 列表与仓库。
2. 检查环境并修复缺口（见下方检查清单）。
3. 需要用户授权时：打印一次性验证码 + `https://github.com/login/device`，等用户说「好了」再继续。
4. 运行本目录 `scripts/bootstrap.ps1`（Windows）或 `scripts/bootstrap.sh`（macOS/Linux）。
5. 验证：`~/.cursor/skills/<name>/SKILL.md` 存在；`gh auth status` 显示已登录。
6. 用 3～5 行告诉用户结果与下次换电脑怎么说/怎么跑。

## 检查清单

| 检查 | 通过标准 | 失败时 |
|---|---|---|
| `gh` 已安装 | `gh --version` | Windows: `winget install --id GitHub.cli -e`；macOS: `brew install gh` |
| 已登录 GitHub | `gh auth status` 含 Logged in | `gh auth login -h github.com -p https -w`（设备码流程） |
| 网络可达 | `gh api user --jq .login` 有用户名 | 换网络/代理后重试；OAuth 超时则建议用户建 PAT（`repo`）后 `gh auth login --with-token` |
| Skills 已安装 | manifest 中每项在 `~/.cursor/skills/` | 执行 bootstrap 脚本 |

### Windows 注意

- 新装 `gh` 后刷新 PATH：`$env:Path = "$env:ProgramFiles\GitHub CLI;" + $env:Path`
- 设备码换 Token 若超时：再开一次 `gh auth login -w`，用户授权后立刻检测，勿假定浏览器点完就已登录。

## 设备码登录（Agent 操作要点）

```powershell
# 启动后立刻读输出，把 code 发给用户
gh auth login -h github.com -p https -w
```

对用户只说两件事：打开 https://github.com/login/device ，输入验证码 `XXXX-XXXX`。用户回复「好了」后再跑 `gh auth status`；若仍未登录，说明是换 Token 失败，重开登录或改用 PAT。

## 新电脑「零 Skill」冷启动

本 Skill 尚未装上时，让用户先跑（收藏这一条即可）：

```powershell
# Windows PowerShell
irm https://raw.githubusercontent.com/zhaozr815/cursor-skills/main/scripts/bootstrap.ps1 | iex
```

```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/zhaozr815/cursor-skills/main/scripts/bootstrap.sh | bash
```

脚本会：必要时提示安装/登录 `gh`，克隆本仓库，把各 skill 拷进 `~/.cursor/skills/`（含本 setup skill 与周报 skill）。

之后用户只需对 Agent 说：「同步我的 skills」或「连接 GitHub」。

## 日常同步（已装过）

优先执行：

```powershell
& "$env:USERPROFILE\.cursor\skills\github-skills-setup\scripts\bootstrap.ps1"
```

或在仓库目录：`.\scripts\bootstrap.ps1 -SyncOnly`

行为：`git pull` 各源 → 覆盖安装到 `~/.cursor/skills/`（不删用户自建、不在 manifest 里的 skill）。

## 对用户说明（简短）

- 换电脑：浏览器收藏 bootstrap 链接，或说「安装我的 Cursor skills」。
- 登录一次 `gh` 后，同步一般不再要完整 OAuth（Token 在本机 keyring）。
- 不要把 Skill 放进 `~/.cursor/skills-cursor/`（系统目录）。

## 相关文件

- 清单：[manifest.md](manifest.md)
- 脚本：`scripts/bootstrap.ps1`、`scripts/bootstrap.sh`