安装教程
从零开始学会安装和管理 AI 技能包。10 分钟读完,3 步装好第一个 Skill。
选择你的平台
Skill岛 收录的技能包支持三个平台。每个技能包的详情页会标注它支持哪些平台,请先确认你使用的平台在支持列表里。
Claude Code 安装
Claude Code 默认从 ~/.claude/skills/ 目录加载技能包。目录结构如下:
示例:安装来自 greensock/gsap-skills 的「网页动画核心技能包」:
npx skills add https://github.com/greensock/gsap-skills
Codex 安装
Codex 从 ~/.codex/skills/ 目录加载。命令行用法与 Claude Code 一致,仅目录不同:
Cursor 安装
Cursor 在用户主目录下的 ~/.cursor/skills/ 加载技能包。安装命令同 Claude Code,仅目标目录不同。
手动安装 SKILL.md
提示:当前技能包没有远程安装命令时,你可以复制 SKILL.md 内容,手动保存到对应目录。
- 1在技能包详情页找到「SKILL.md 预览」,点击「复制 SKILL.md」
- 2在终端创建目录:
mkdir -p ~/.claude/skills/<skill-name> - 3用任意编辑器在该目录下创建
SKILL.md,粘贴刚才复制的内容并保存 - 4重启客户端,发送示例提示词验证
常见问题
装了 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 是纯文本,用任何编辑器打开就能修改。改完保存即可生效(必要时重启客户端)。
安全提醒
Skill 不只是提示词。有些 Skill 可能包含脚本、命令、文件操作或联网请求。
安装前请先查看详情页的安全风险章节,尤其是高风险或带脚本的 Skill,不建议新手直接安装。
给新手的安全建议
- 1第一次安装从「新手推荐」分类里挑,低风险 + 无脚本,避免误操作系统
- 2安装前先看详情页的 SKILL.md 预览,了解它的内容再决定要不要装
- 3带脚本的 Skill 一定要先看源码,理解每条命令的作用
- 4在隔离环境(如 Docker、虚拟机)测试不熟悉的 Skill
- 5定期清理 ~/.claude/skills 目录,删除不用的 Skill 减少冲突