Skill岛
00/安装教程

安装教程

从零开始学会安装和管理 AI 技能包。10 分钟读完,3 步装好第一个 Skill。

01/安装教程

选择你的平台

Skill岛 收录的技能包支持三个平台。每个技能包的详情页会标注它支持哪些平台,请先确认你使用的平台在支持列表里。

Claude Code
Anthropic 出品的命令行 AI 编程助手,原生支持 SKILL 系统
Codex
OpenAI 出品的开源 AI 编程工具
Cursor
AI 代码编辑器,支持在项目内使用 SKILL
02/安装教程

Claude Code 安装

Claude Code 默认从 ~/.claude/skills/ 目录加载技能包。目录结构如下:

~/.claude/skills/
└── gsap-core/
└── SKILL.md

示例:安装来自 greensock/gsap-skills 的「网页动画核心技能包」:

安装命令
npx skills add https://github.com/greensock/gsap-skills
03/安装教程

Codex 安装

Codex 从 ~/.codex/skills/ 目录加载。命令行用法与 Claude Code 一致,仅目录不同:

~/.codex/skills/
└── gsap-core/
└── SKILL.md
04/安装教程

Cursor 安装

Cursor 在用户主目录下的 ~/.cursor/skills/ 加载技能包。安装命令同 Claude Code,仅目标目录不同。

~/.cursor/skills/
└── gsap-core/
└── SKILL.md
05/安装教程

手动安装 SKILL.md

提示:当前技能包没有远程安装命令时,你可以复制 SKILL.md 内容,手动保存到对应目录。

  1. 1在技能包详情页找到「SKILL.md 预览」,点击「复制 SKILL.md」
  2. 2在终端创建目录:mkdir -p ~/.claude/skills/<skill-name>
  3. 3用任意编辑器在该目录下创建 SKILL.md,粘贴刚才复制的内容并保存
  4. 4重启客户端,发送示例提示词验证
06/安装教程

常见问题

装了 Skill 不生效怎么办?

1) 确认 SKILL.md 文件位置正确;2) 重启 Claude Code / Cursor 客户端;3) 检查 SKILL.md 第一行的 # 名称是否与目录名一致;4) 在对话里明确说「请使用 XXX 技能包」强制触发。

在哪个目录找到已安装的 Skill?

macOS / Linux:~/Library/Application Support/Claude/skills/ 或 ~/.claude/skills/(视版本而定)。Windows:%USERPROFILE%\.claude\skills\。Cursor:~/.cursor/skills/。

如何卸载 Skill?

直接删除对应的 skills/<skill-name> 目录,然后重启客户端即可。Skill 不会在系统中留下其他残留文件。

如何更新到最新版?

重新执行一次安装命令(如果是 npx skills add 类命令),或重新下载 SKILL.md 覆盖原文件。Skill 本身无版本系统,文件覆盖即更新。

同一个 Skill 多平台通用吗?

SKILL.md 本身是跨平台的 Markdown 文件,但触发的命令或脚本可能依赖特定工具的 API。详情页会标注支持的平台,请按标注使用。

可以自己改 SKILL.md 吗?

完全可以。SKILL.md 是纯文本,用任何编辑器打开就能修改。改完保存即可生效(必要时重启客户端)。

07/安装教程

安全提醒

Skill 不只是提示词。有些 Skill 可能包含脚本、命令、文件操作或联网请求。

安装前请先查看详情页的安全风险章节,尤其是高风险或带脚本的 Skill,不建议新手直接安装。

给新手的安全建议

  • 1第一次安装从「新手推荐」分类里挑,低风险 + 无脚本,避免误操作系统
  • 2安装前先看详情页的 SKILL.md 预览,了解它的内容再决定要不要装
  • 3带脚本的 Skill 一定要先看源码,理解每条命令的作用
  • 4在隔离环境(如 Docker、虚拟机)测试不熟悉的 Skill
  • 5定期清理 ~/.claude/skills 目录,删除不用的 Skill 减少冲突