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

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

先说清楚我是谁：一个完全没用过 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，直接复用，没重复生成）：

```bash
# 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 无脚本最好；有脚本的要过一遍安全自查（无危险命令）。

推送命令：

```bash
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 认不出是谁，头像不显示、点不进主页。**要在推送前配好身份**：

```bash
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 检索，非本人实测；收录时效因平台而异）。

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

```bash
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 工具，真正跑通。*

---

---


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

实战：AI 手把手带你发布第一个 Agent Skill 到 GitHub（小白向全流程）

GitHub 新手在 AI 引导下发布第一个 Agent Skill 的完整实记：改用户名、配 SSH、建仓、推送 SKILL.md、打标签自测 5 步，附 4 个实测踩坑，纯操作约 40 分钟、0 成本，仓库 sichenai/sichen-skills 已上线。

人工智能

开发工具

新闻资讯

GitHub小白用AI引导，40分钟发布3个Agent Skill全流程实录。从改用户名、配SSH Key到建仓库、推送SKILL.md、打标签自测，5步跑通npx skills add安装验证。附4个新手必踩认知盲区（密码push被拒、commit作者不关联等）及解决方案，零成本实现AI技能公开分发。

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

实战：AI 手把手带你发布第一个 Agent Skill 到 GitHub（小白向全流程）-腾讯云开发者社区-腾讯云

实战：AI 手把手带你发布第一个 Agent Skill 到 GitHub（小白向全流程）

实战：AI 手把手带你发布第一个 Agent Skill 到 GitHub（小白向全流程）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐