如何安装 Agent Skills
三种方式把任意 Skill 装进 Claude Code、Codex 或 Cursor，以及如何确认安装成功。
一句话版本
Agent 已经打开？粘贴安装提示词。在终端里？运行一条 npx 命令。想先看代码？克隆仓库后复制文件夹。当 SKILL.md 直接位于 Skill 文件夹内、并且 Agent 能列出它时，就安装成功了。
1. 安装提示词（最简单）
每个 Skill 页面都有安装提示词。粘贴到 Claude Code、Codex 或 Cursor，Agent 会读取本站面向 Agent 的 install.md 并自行运行正确的命令。
安装提示词
Read https://skilloop.dev/skills/<slug>/install.md and follow the instructions to install the skill.
2. 一行命令
我们使用开源的 `skills` CLI（vercel-labs/skills，MIT）。它会克隆源仓库，并把 Skill 文件夹复制到各 Agent 对应的位置。
Claude Code（全局）
npx skills add <owner>/<repo> --skill <name> -g -a claude-code
Codex / Cursor（全局）
npx skills add <owner>/<repo> --skill <name> -g -a codex -a cursor
仅当前项目
npx skills add <owner>/<repo> --skill <name> -a claude-code
3. 手动安装（git）
请复制整个文件夹，而不仅是 SKILL.md——说明里经常引用同目录的脚本和素材。
Claude Code
git clone --depth 1 https://github.com/<owner>/<repo>.git /tmp/repo mkdir -p ~/.claude/skills && cp -r /tmp/repo/skills/<name> ~/.claude/skills/<name>
4. Skilloop 原创 Skill（ZIP）
原创 Skill 以 ZIP 形式从本站下载。ZIP 内已包含 Skill 文件夹，直接解压到 skills 目录即可。
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skilloop.dev/downloads/skills/<slug>.zip -o /tmp/<slug>.zip && unzip -oq /tmp/<slug>.zip -d ~/.claude/skills/
Codex / Cursor
mkdir -p ~/.agents/skills && curl -fsSL https://skilloop.dev/downloads/skills/<slug>.zip -o /tmp/<slug>.zip && unzip -oq /tmp/<slug>.zip -d ~/.agents/skills/
各 Agent 读取 Skill 的位置
| Agent | 全局目录 | 项目目录 |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ | .claude/skills/<name>/ |
| Codex | ~/.agents/skills/<name>/ | .agents/skills/<name>/ |
| Cursor | ~/.agents/skills/<name>/ | .agents/skills/<name>/ |
| Gemini CLI / OpenCode | ~/.agents/skills/<name>/ | .agents/skills/<name>/ |
检查是否安装成功
正确：~/.claude/skills/my-skill/SKILL.md。错误：~/.claude/skills/my-skill/my-skill/SKILL.md（ZIP 多了一层）或 SKILL.md 直接散落在 skills/ 下。若 Agent 没识别新 Skill，请重启后让它列出可用 Skill。
安全
Skill 是 Agent 可能执行的指令和代码。安装前请阅读 SKILL.md 与脚本，优先选择许可证和来源清晰的 Skill，不要把 API Key 写进 Skill 文件。