本文首发于 斯晨的AI笔记（note.sichenai.cc），原文链接：https://note.sichenai.cc/articles/github-skill-publish，作者：斯晨。

视角说明：我是 GitHub 完全新手，本文记录我在 AI 引导下一步步完成的全过程。第一人称实记，全程可复现，所有命令真实跑过。

成果锚点：仓库 sichenai/sichen-skills（3 个 Skill 已上线，npx skills add 自测通过）

---

结论先行（不想看过程的看这里）

先说清楚我是谁：一个完全没用过 GitHub 的新手，唯一会的就是用 AI 做东西——我用 AI 做了 3 个 Agent Skill（长项目交接、第一性原理分析、反复澄清确认），一直放在自己电脑上。

今天下午，在 AI 的引导下，我把它们发上了 GitHub，并且让它们可以被任何人一键安装。发完之后我自己都不敢信——从「完全不懂」到「跑通」，全程 5 步，纯操作累计约 40 分钟（每步耗时见正文，估算值）：

1. 改用户名：注册时 GitHub 自动生成的邮箱前缀用户名，改成品牌名；
2. 配 SSH Key：让电脑和 GitHub 之间建立免密通道（不是设密码！）；
3. 建仓库：public 仓库，文件本地建好再推，别让网页自动生成；
4. 推送 SKILL.md：标准格式 + 无硬编码路径，git push 上远端；
5. 打标签 + 自测：加 Topics（爬虫收录关键）+ npx skills add 验证可安装。

真正的难点不是命令，是 4 个认知盲区——新手最容易在这 4 处卡住，我全踩了一遍：

• 我以为设个密码就能 push → GitHub 2021 年起禁止密码 push；
• 我以为提交作者会自动归到自己账户 → 没配 git 身份时，commit 显示的是电脑名，别人点不进你主页；
• 我以为改资料在 Settings 里 → 新版 GitHub 把它移到了主页右侧齿轮（连引导我的 AI 都指错两次）；
• 我以为仓库名大小写无所谓 → 爬虫按仓库名收录，大小写不一致影响匹配。

---

一、我是谁：会用 AI，但完全不懂 GitHub

我为什么会想发 Skill？三个理由：

1. 作品集：GitHub 是 AI 圈的事实简历——commit 记录、README、skill 清单都是可信度证据；
2. 可被安装：SKILL.md 是开放标准（Anthropic 2025-12 发布），Claude Code、Codex CLI、Cursor、OpenClaw 等 20+ Agent 都认，发上去别人 npx skills add 就能装；
3. 引流承接：配合我的内容站（note.sichenai.cc），形成「内容 → 仓库 → 安装」的闭环。

但问题是：我完全不懂 GitHub。注册过账号，仅此而已。上次打开它可能是一年前。

所以我的办法是：让 AI 一步一步带我。下面每一步，我都记录了我当时的想法、AI 教我的操作、以及我卡住的地方——如果你也是新手，你会知道每一步为什么。

---

二、5 步流程（全程实记）

Step 1 · 改用户名（约 5 分钟）

我遇到的第一件事：打开 GitHub 右上角菜单，发现自己显示的是一个怪名字——邮箱前缀-撞名后缀。

AI 告诉我：注册时 GitHub 自动用邮箱 @ 前面那段当默认用户名，撞名了再加后缀。这不是 bug，是默认行为。

跟着操作：Settings → Account → Change username，改成品牌名（我的域名是 sichenai.cc，所以改成 sichenai）。

三个我差点忽略的点：

• 旧用户名改完立刻释放，别人能抢注——越早改越好；
• 改名后所有链接自动重定向，零损失；
• 菜单主文本显示的是 Username（唯一 handle），Name（显示名）只是展示——两个都要设，别只改一个。

Step 2 · 配 SSH Key（约 5 分钟，一次配永久免密）

我的第一反应：“我设个密码就能推送了吧？”

AI 拦住了我：不行。GitHub 2021 年 8 月起禁止用密码 git push（无论设没设密码），必须走 Token 或 SSH。SSH 是长期方案，配一次永久免密。

跟着操作（我电脑上恰好已有 key，直接复用，没重复生成）：

# 1. 检查本机是否已有 key（有就复用，别重复生成）
ls ~/.ssh/id_ed25519.pub

# 2. 没有才生成（一路回车）
ssh-keygen -t ed25519 -C "你的邮箱"

# 3. 复制公钥
pbcopy < ~/.ssh/id_ed25519.pub

# 4. 网页粘贴：github.com/settings/keys → New SSH key → Cmd+V → Add SSH key

# 5. 验证
ssh -T git@github.com
# 看到 Hi sichenai! You've successfully authenticated 即通过

我在这步卡了一下：公钥是一长串字符，AI 提醒我复制的时候要把 ssh-ed25519 AAAA... 整串完整复制，不能漏。粘贴完点 Add SSH key，会要求验证一次账户。

Step 3 · 建仓库（约 3 分钟）

AI 给的铁律：README/LICENSE 都本地建好再推，网页建仓时三个 “Add” 开关全部保持 Off。

我建仓时，网页上有三个开关：Add README / Add .gitignore / Add license。

AI 特别叮嘱保持 Off——如果打开，GitHub 会自动生成一个初始 commit，等你本地 push 时会因远端已有 commit 被拒（non-fast-forward），被迫 rebase 或 force push，新手直接懵。

Description 要填：一句话说清仓库是什么（列表页和爬虫都读这句）。

Step 4 · 推送 SKILL.md（约 10 分钟）

仓库结构（每个 Skill 一个目录，SKILL.md 是标准格式）：

sichen-skills/
├── README.md
├── LICENSE              # MIT
└── skills/
    ├── new-convo-handoff/SKILL.md
    ├── first-principles/SKILL.md
    └── clarify-until-clear/SKILL.md

SKILL.md 的发布级要求（AI 给的检查清单）：

• frontmatter 必须有 name + description（description 即触发语，写清触发词）；
• 无硬编码路径：把 /Users/xxx/ 这类私有路径、用户名、项目名全部中性化；
• 无硬编码凭证：API Key 一律走环境变量，不留字面值；
• 纯文档型 Skill 无脚本最好；有脚本的要过一遍安全自查（无危险命令）。

推送命令：

cd 你的仓库目录
git init
git add .
git commit -m "feat: publish N agent skills"
git branch -M main
git remote add origin git@github.com:你的用户名/仓库名.git   # SSH 格式
git push -u origin main

我在这里踩了最大的坑：commit 发上去了，但 AI 让我检查一下——发现作者显示的是我的电脑名（电脑名 <xxx@Mac.local>），GitHub 认不出是谁，头像不显示、点不进主页。要在推送前配好身份：

git config --global user.name "你的用户名"
git config --global user.email "你的noreply邮箱"   # GitHub 设置页里查，形如 12345678+username@users.noreply.github.com

（如果你已经推了才发现作者不对，也别慌：用 git filter-branch 重写历史作者 + force push 可以修正，AI 帮我操作过一次。）

Step 5 · 打标签 + 自测（约 5 分钟）

打 Topics（爬虫靠这个收录，关键）：仓库主页右侧 About 齿轮 → Topics 添加：
agent-skills、claude-skill、claude-skills、skills、ai-agents

打上后 skills.sh、SkillsMP、claude-plugins.dev 等目录爬虫会自动收录，零额外成本（来源：第三方平台盘点文章 2026-08 检索，非本人实测；收录时效因平台而异）。

自测（验证别人真的能装）：

npx skills add 你的用户名/仓库名

最激动的一刻：终端输出 Repository cloned → Found 3 skills → 列出 3 个 skill 名 + 读取到 description。看到 Found N skills 那一刻我知道：格式完全合规，任何 Agent 都能识别，发布成功了。

---

三、踩坑清单（4 个，全部实测）

#	坑	现象	解决
1	用户名是邮箱前缀	菜单显示 邮箱前缀-撞名后缀，不像品牌	Settings → Account → Change username 改品牌名
2	密码 push 被拒	以为设个密码就能推送	GitHub 2021 起禁密码 push；用 SSH Key（一次配好永久免密）
3	commit 作者不关联账户	commit 显示 电脑名 <xxx@Mac.local>，点不进主页	推送前配 git config --global user.name/email（email 用 noreply 邮箱）
4	About 编辑找不到	Settings 里根本没有 About 区块	新版 GitHub 把它移到仓库主页右侧 About 齿轮（连引导我的 AI 都指错两次）

补充两个细节坑：

• npx skills add 首次会问是否装 CLI 包，按 y 即可；
• 自测完本机不需要真装（我本地已有副本），直接 Ctrl+C 取消，验证目的已达到。

一个诚实的说明：踩坑 #4 连 AI 都踩了——它一开始让我去 Settings 里找 About 编辑，结果 Settings 页面里根本没有；试了两次才确认入口在主页右侧齿轮。AI 不是不会犯错，但错了会修正，修正的过程就是这篇教程的一部分。

---

四、成本与数据（不吹）

项	数据
时间	每步耗时见正文（估算值）；纯操作累计约 40 分钟；全程含研究、决策、踩坑返工约 2-3 小时（中途有休息，未掐表）
费用	0 元（GitHub 免费额度足够）
效果	仓库上线、npx skills add 自测 Found 3 skills、About 区块（描述/网站/Topics）生效
收录	打标签后 skills.sh/SkillsMP 等目录爬虫自动收录（来源：第三方平台盘点文章 2026-08 检索，非本人实测；时效因平台而异）

判断标准：一个 Skill 仓库「发好了」= 仓库公开 + npx skills add 能识别 + About 有描述和 Topics。三者齐了，分发主链路就通了。

---

五、为什么这篇值得写：新手的路，就是所有人的路

写这篇之前，AI 问我一个问题：“你觉得这段经历对别人有什么用？”

我想了想：一个会用 AI 但完全不懂 GitHub 的人，在 AI 引导下把事跑通了——这件事本身，就是现在大多数人正在经历的场景。 会用 AI 工具 ≠ 会工程基建，而 AI 恰恰能补上这段差距。这跟我一直做的 GEO 实验是同一件事：

1. 案例层（真实过程）：一个 GitHub 小白 + 一个 AI 引导者，把 3 个 Skill 从「只在自己电脑上用」推进到「GitHub 公开可安装」，全过程被记录成文章——命令、报错、解决方式都可溯源；
2. 内容层（可复制方法）：提炼成「5 步流程 + 4 个踩坑」，读者照着做就能复现，不需要踩我踩过的坑；
3. 闭环验证：文章发布后回看——① 这篇能否被 AI 引擎引用；② 文末仓库链接是否带来真实安装/访问。

数据说话，按结果迭代。 教程若被引用 = 案例站被引用的又一个实例，双向飞轮转起来。

---

仓库地址：https://github.com/sichenai/sichen-skills（3 个 Skill 在线，欢迎安装试用）
站点：note.sichenai.cc · 把 AI 工具，真正跑通。