真小白也能看懂：怎么安装 GitHub 上的 AI Skill

这篇写给完全不懂终端、GitHub、Skill 安装的人。

我会尽量把那些「别人以为你肯定懂」的地方讲清楚，比如 Git 是什么、仓库是什么、SKILL.md 和 AGENTS.md 有什么区别。

这里先讲通用安装逻辑，不展开某一个 Skill 的完整案例。

一、安装 Skill 到底是在做什么？

很多人第一次听到「安装 GitHub Skill」，会以为它和安装普通软件差不多：下载、安装，然后桌面上出现一个 App。

大多数时候不是这样。

GitHub 上的 AI Skill，通常是一组给 AI 工具看的文件。里面可能是规则、提示词、说明，也可能带一点脚本。

它主要告诉 AI：

接下来按什么风格工作
 要遵守哪些规则
 怎么处理用户输入
 最后用什么格式输出

所以安装 Skill，说白了就是：

先把 GitHub 上的规则文件下载到电脑，
 再放到你的 AI 工具能读取的位置。

二、先认识 3 个东西

1. GitHub 是什么？

GitHub 可以先理解成一个放代码和文件的网站。

别人把 Skill 放在 GitHub 上，你要做的第一步，就是把它下载到自己的电脑。

1. Git 是什么？

Git 是一个用来下载和管理 GitHub 仓库的工具。

你在终端输入：

git clone 仓库链接

意思就是：

把这个 GitHub 仓库下载到我的电脑。

1. Skill 文件一般叫什么？

常见文件名有：

README.md

SKILL.md

AGENTS.md

instructions.md

prompt.md

rules.md

先记住这三个就够了：

README.md = 项目说明

SKILL.md = 很多 Skill 的规则文件

AGENTS.md = Codex 常用的规则文件

三、先确认你用哪个 AI 工具

安装前先确认一件事：

这个 Skill 是给哪个工具用的？

常见工具有：

Claude Code

OpenAI Codex

Cursor

Windsurf

OpenCode

Aider

Augment

名字像，不代表是同一个东西。尤其注意这几个：

Claude Code != OpenAI Codex

OpenCode != OpenAI Codex

OpenClaw != OpenAI Codex

如果安装器里没有你正在用的工具，不要随便选一个名字差不多的。

记住这个原则：

你用哪个工具，就选哪个工具。

没有你的工具，就先别选。

四、通用流程

不管装哪个 Skill，大体都绕不开这些步骤：

打开终端

检查 Git 有没有安装

复制 GitHub 仓库链接

用 git clone 下载仓库

进入仓库文件夹

查看 README.md

找到 SKILL.md 或 AGENTS.md

确认你的 AI 工具支持哪种文件

把规则文件放到正确位置

启动 AI 工具测试

下面一步步来。

五、打开终端

macOS 打开：

终端 / Terminal

Windows 打开：

PowerShell / Windows Terminal / Git Bash

Linux 打开：

Terminal

终端不是 AI 聊天框。它只能执行命令。

比如：

ls

cd

git clone

cp

codex

不要把中文任务直接输到普通终端里。

错误示例：

请帮我改写这段话

终端会把这句话当成命令，然后可能报：

command not found

六、检查 Git 有没有安装

在终端输入：

git --version

如果看到类似下面的内容，说明 Git 已经装好了：

git version 2.39.5

如果提示找不到 git，先安装 Git，再回来继续。

七、复制 GitHub 仓库链接

GitHub 仓库链接一般长这样：

https://github.com/作者名/项目名

在终端下载时，常用带 .git 的形式：

https://github.com/作者名/项目名.git

命令模板：

git clone https://github.com/作者名/项目名.git

八、下载 Skill 仓库

在终端输入：

git clone 仓库链接

这一步会把 GitHub 上的仓库下载到你的电脑。下载完后，当前目录里会多出一个同名文件夹。

九、进入仓库文件夹

输入：

cd 仓库名

cd 的意思是进入某个文件夹。

如果仓库名叫 xxx-skill，就输入：

cd xxx-skill

十、查看里面有什么文件

输入：

ls

重点看有没有这些：

README.md

SKILL.md

AGENTS.md

看到 README.md，先读它。看到 SKILL.md，这个仓库大概率就是一个 Skill。

十一、阅读 README.md

输入：

cat README.md

README 通常会写清楚：

这个 Skill 是做什么的

支持哪些 AI 工具

推荐怎么安装

有没有一键安装命令

怎么测试

如果 README 给了安装命令，先看它是给哪个工具用的。别看到命令就直接复制。

十二、安装器让你选工具怎么办？

有些 Skill 安装器会让你选工具，比如：

Claude Code

OpenCode

OpenClaw

AiderDesk

Augment

还是那句话：

你实际用哪个工具，就选哪个工具。

没有你的工具，就不要硬选。

如果你用的是 OpenAI Codex，但列表里没有 Codex，就不要选：

Claude Code

OpenCode

不认识的工具

退出安装器一般按：

Ctrl + C

十三、Claude Code 的常见安装方式

如果你用的是 Claude Code，常见 Skill 目录是：

~/.claude/skills

常见安装命令：

git clone 仓库链接 ~/.claude/skills/skill名称

装完后重启 Claude Code。

如果 README 里写了触发命令，比如：

/skill-name

就在 Claude Code 里输入它测试。

十四、OpenAI Codex 的常见处理方式

Codex 通常不能直接安装 Claude Code Skill。

很多 Skill 仓库的核心文件叫：

SKILL.md

而 Codex 更常读取：

AGENTS.md

所以给 Codex 用时，常见做法是把 SKILL.md 复制成 AGENTS.md。

命令：

cp SKILL.md ~/AGENTS.md

这行命令的意思是：

把当前文件夹里的 SKILL.md

复制到用户主目录

并命名为 AGENTS.md

然后回到主目录：

cd ~

启动 Codex：

codex

进入 Codex 后，再输入你的中文任务。

十五、AGENTS.md 放哪里？

常见有两种放法。

方式 1：放到主目录

cp SKILL.md ~/AGENTS.md

cd ~

codex

这个最适合新手，简单直接。

方式 2：放到项目目录

如果你有固定项目，更推荐把 AGENTS.md 放到项目根目录。

模板：

cp SKILL.md 项目文件夹/AGENTS.md

cd 项目文件夹

codex

这样 Codex 在这个项目里工作时，会读取这个项目里的规则。

十六、怎么判断 Skill 生效了？

不要只看终端有没有报错。

真正要看的是：

AI 有没有按这个 Skill 的规则工作。

测试方法很简单：让 AI 做一个符合这个 Skill 用途的小任务，然后看输出是不是符合规则。

如果 AI 完全没按规则走，常见原因有这些：

规则文件放错位置

文件名不对

启动目录不对

工具不支持这种 Skill

没有重启工具

十七、常见错误

错误 1：以为 git clone 就是安装完成

git clone 只是下载仓库。

下载后还要找到规则文件，放到目标工具能读取的位置，再启动工具测试。

错误 2：把中文任务输到普通终端

普通终端不是 AI 聊天框。

先启动 AI 工具，再输入中文任务。

错误 3：把 Claude Code 当成 Codex

Claude Code 和 OpenAI Codex 不是同一个工具。

给 Claude Code 安装 Skill，不代表 Codex 一定能用。

错误 4：把 OpenCode 当成 OpenAI Codex

OpenCode 和 OpenAI Codex 也不是同一个东西。

名字像，但不能混用。

错误 5：看到网络报错就以为 Skill 没装好

如果看到：

request timed out

stream disconnected before completion

HTTP request failed

通常是网络连接问题，不一定是 Skill 安装失败。

常见原因：

网络不稳定

代理/VPN 不稳定

ChatGPT 登录状态异常

AI 工具服务临时连接失败

十八、多个 Skill 怎么管理？

如果以后会安装多个 Skill，不建议都直接覆盖成：

~/AGENTS.md

后复制的 Skill 会覆盖前一个。

更清楚的做法是建一个专门的文件夹：

mkdir -p ~/codex-skills

以后每个 Skill 单独放一个目录：

git clone 仓库链接 ~/codex-skills/skill名称

要用哪个 Skill，再把它复制成当前 Codex 要读的 AGENTS.md：

cp ~/codex-skills/skill名称/SKILL.md ~/AGENTS.md

cd ~

codex

十九、设置快捷命令

如果你经常用某个 Skill，可以设置快捷命令。

比如启动 Codex：

echo 'alias 启动AI="cd ~ && codex"' >> ~/.zshrc && source ~/.zshrc

以后打开终端，只要输入：

启动AI

如果想让快捷命令自动切换某个 Skill，也可以这样写：

echo 'alias 使用某skill="cp ~/codex-skills/skill名称/SKILL.md ~/AGENTS.md && cd ~ && codex"' >> ~/.zshrc && source ~/.zshrc

以后输入：

使用某skill

它会自动做三件事：

复制对应 Skill 规则

进入主目录

启动 Codex

二十、最小命令模板

下载任意 GitHub Skill：

git clone 仓库链接

cd 仓库名

ls

cat README.md

给 Claude Code 用：

git clone 仓库链接 ~/.claude/skills/skill名称

给 Codex 用：

cp SKILL.md ~/AGENTS.md

cd ~

codex

多个 Skill 管理：

mkdir -p ~/codex-skills

git clone 仓库链接 ~/codex-skills/skill名称

cp ~/codex-skills/skill名称/SKILL.md ~/AGENTS.md

cd ~

codex

二十一、最后记住这一句

安装 GitHub Skill，本质就是：

把 GitHub 上的规则文件下载下来，

放到你的 AI 工具能读取的位置。

如果你用 Codex，再多记一句：

很多 Skill 的规则文件叫 SKILL.md，

Codex 更常用 AGENTS.md。

所以可以把 SKILL.md 复制成 AGENTS.md。

最常用命令模板：

git clone 仓库链接

cd 仓库名

cp SKILL.md ~/AGENTS.md

cd ~

codex

二十二、写在最后

对于真小白来说，安装 GitHub Skill 最容易卡住的地方，不是命令本身，而是分不清三件事：

GitHub 仓库只是文件来源

Skill 文件只是规则

真正决定能不能用的是你的 AI 工具能不能读取这些规则

所以，下载成功不等于安装成功。

真正算装好了，是你启动 AI 工具之后，它能按这个 Skill 的规则完成任务。

以后再遇到新的 Skill，不用从头理解一遍。按这条路走就行：

看 README

找 SKILL.md

确认自己用的工具

放到正确位置

启动后测试

这五步能走通，基本就装明白了。