安装技能指南

从图灵工坊下载 ZIP 后，如何将其安装到各主流 AI 编码平台。支持 macOS、Linux、Windows 三大操作系统。

通用说明

本站分发的技能均为 ZIP 压缩包，每个 ZIP 内顶层是一个技能目录（目录名即技能名），典型结构如下：

my-skill/
├── SKILL.md 技能定义（必需）
├── scripts/ 辅助脚本（可选）
└── references/ 参考资料（可选）

安装通用三步：

  1. 在技能详情页点击「下载 ZIP」，获取压缩包（如 my-skill.zip）
  2. 解压到目标平台对应的 skills / rules 目录（详见下文各平台）
  3. 重启或重新加载客户端，使其发现新技能；在对话中通过斜杠命令或自然语言触发
Mac / Linux（bash / zsh）
mkdir -p ~/.X/skills/ unzip my-skill.zip -d ~/.X/skills/ ls ~/.X/skills/my-skill/SKILL.md
Windows（PowerShell）
mkdir $HOME\.X\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.X\skills Test-Path $HOME\.X\skills\my-skill\SKILL.md
提示： 下文命令中的 my-skill.zip 请替换为您实际下载的文件名；.X 替换为各平台对应目录名（如 .claude、.codex）。ZIP 内顶层目录名即为技能名，无需手动重命名。
Windows 用户注意： 以下所有 Windows 命令均在 PowerShell 中执行（Windows 10+ 自带）。旧版 CMD 不支持 Expand-Archive，可在文件资源管理器中右键 ZIP →「解压到此处」作为替代。

1. OpenClaw

本地优先的 AI 助手，支持通过 ClawHub 或本地目录管理技能。

Mac / Linux~/.openclaw/skills/<skill-name>/SKILL.md
Windows%USERPROFILE%\.openclaw\skills\<skill-name>\SKILL.md
Mac / Linux（bash / zsh）
mkdir -p ~/.openclaw/skills unzip my-skill.zip -d ~/.openclaw/skills/ ls ~/.openclaw/skills/
Windows（PowerShell）
mkdir $HOME\.openclaw\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.openclaw\skills Get-ChildItem $HOME\.openclaw\skills

或使用 OpenClaw CLI 直装（若技能已发布到 ClawHub，命令在三大 OS 上一致）：

openclaw skills install my-skill

2. Hermes

Nous Research 出品的自学习 AI Agent，内置技能系统，支持从 URL 或 GitHub 拉取。

Mac / Linux~/.hermes/skills/<skill-name>/SKILL.md
Windows%USERPROFILE%\.hermes\skills\<skill-name>\SKILL.md
Mac / Linux（bash / zsh）
mkdir -p ~/.hermes/skills unzip my-skill.zip -d ~/.hermes/skills/ ls ~/.hermes/skills/
Windows（PowerShell）
mkdir $HOME\.hermes\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.hermes\skills Get-ChildItem $HOME\.hermes\skills

或使用 Hermes CLI 从 URL 直装（命令在三大 OS 上一致）：

hermes skills install https://example.com/my-skill/SKILL.md

3. Claude Code

Anthropic 官方 CLI，支持个人级（全局）与项目级两类技能目录，路径在三大 OS 上结构一致，仅家目录前缀不同。

Mac / Linux~/.claude/skills/<skill-name>/SKILL.md
Windows%USERPROFILE%\.claude\skills\<skill-name>\SKILL.md
项目级<项目根>/.claude/skills/<skill-name>/SKILL.md
Mac / Linux（bash / zsh） · 全局安装（推荐）
mkdir -p ~/.claude/skills unzip my-skill.zip -d ~/.claude/skills/ ls ~/.claude/skills/my-skill/SKILL.md
Windows（PowerShell） · 全局安装（推荐）
mkdir $HOME\.claude\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.claude\skills Test-Path $HOME\.claude\skills\my-skill\SKILL.md
Mac / Linux · 项目级安装（仅当前项目生效）
cd /path/to/your-project mkdir -p .claude/skills unzip my-skill.zip -d .claude/skills/
Windows · 项目级安装（仅当前项目生效）
cd C:\path\to\your-project mkdir .claude\skills Expand-Archive my-skill.zip -DestinationPath .\.claude\skills

安装后在会话中输入 /技能名 触发，或由模型根据上下文按需自动加载。

4. Codex CLI

OpenAI 官方本地编码 Agent，技能放在用户级目录会被自动发现。Codex 同时支持 AGENTS.md 跨工具标准。

Mac / Linux~/.codex/skills/<skill-name>/SKILL.md
Windows%USERPROFILE%\.codex\skills\<skill-name>\SKILL.md
项目级<项目根>/.agents/skills/<skill-name>/SKILL.md
Mac / Linux（bash / zsh） · 用户级（全局，推荐）
mkdir -p ~/.codex/skills unzip my-skill.zip -d ~/.codex/skills/ ls ~/.codex/skills/
Windows（PowerShell） · 用户级（全局，推荐）
mkdir $HOME\.codex\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.codex\skills Get-ChildItem $HOME\.codex\skills
Mac / Linux · 项目级
cd /path/to/your-project mkdir -p .agents/skills unzip my-skill.zip -d .agents/skills/
Windows · 项目级
cd C:\path\to\your-project mkdir .agents\skills Expand-Archive my-skill.zip -DestinationPath .\.agents\skills
注意： 项目级目录 .agents/skills/ 必须是真实目录，不能用符号链接（symlink）替代，否则 Codex 不会加载其中的技能。

5. Cursor

AI IDE，使用 .mdc（带 frontmatter 的 Markdown）规则文件。项目级规则为官方支持，全局规则需手动在家目录创建。

Mac / Linux 全局~/.cursor/rules/<name>.mdc
Windows 全局%USERPROFILE%\.cursor\rules\<name>.mdc
项目级<项目根>/.cursor/rules/<name>.mdc
Mac / Linux（bash / zsh） · 全局
mkdir -p ~/.cursor/rules unzip my-skill.zip -d ~/.cursor/rules/
Windows（PowerShell） · 全局
mkdir $HOME\.cursor\rules Expand-Archive my-skill.zip -DestinationPath $HOME\.cursor\rules
重要： Cursor 的 .mdc 文件需要 frontmatter（如 description、globs 等字段）。本站 ZIP 内是标准 SKILL.md，请按以下步骤转换：
  1. 将解压出的 SKILL.md 重命名为 <skill-name>.mdc
  2. 在文件顶部追加 frontmatter：---\ndescription: 技能描述\nglobs: ["**/*"]\n---
  3. 保存后重启 Cursor 让其重新扫描规则目录

6. OpenCode

开源 AI 编码 Agent，兼容 AGENTS.md 标准。注意 Windows 下使用 XDG 风格的 .config 目录，而非 %APPDATA%。

Mac / Linux 全局~/.config/opencode/skills/<name>/SKILL.md
Windows 全局%USERPROFILE%\.config\opencode\skills\<name>\SKILL.md
项目级<项目根>/.opencode/skills/<name>/SKILL.md
Mac / Linux（bash / zsh） · 全局（推荐）
mkdir -p ~/.config/opencode/skills unzip my-skill.zip -d ~/.config/opencode/skills/
Windows（PowerShell） · 全局（推荐）
mkdir $HOME\.config\opencode\skills Expand-Archive my-skill.zip -DestinationPath $HOME\.config\opencode\skills
Mac / Linux · 项目级
cd /path/to/your-project mkdir -p .opencode/skills unzip my-skill.zip -d .opencode/skills/
Windows · 项目级
cd C:\path\to\your-project mkdir .opencode\skills Expand-Archive my-skill.zip -DestinationPath .\.opencode\skills
自定义目录： 可通过环境变量 OPENCODE_CONFIG_DIR 指定全局配置目录位置。
已知问题： v1.0.204 存在全局技能加载失败的 bug，建议升级到更高版本。

7. Cline

VS Code AI 插件。注意全局目录在 Documents/Cline/Rules，不是 ~/.clinerules/（后者仅为工作区项目级目录）。

Mac / Linux 全局~/Documents/Cline/Rules/
Windows 全局%USERPROFILE%\Documents\Cline\Rules\
工作区<项目根>/.clinerules/<skill-name>/
Mac / Linux（bash / zsh） · 全局安装（推荐，所有项目共享）
mkdir -p ~/Documents/Cline/Rules unzip my-skill.zip -d ~/Documents/Cline/Rules/
Windows（PowerShell） · 全局安装（推荐，所有项目共享）
mkdir $HOME\Documents\Cline\Rules Expand-Archive my-skill.zip -DestinationPath $HOME\Documents\Cline\Rules
Mac / Linux · 工作区安装（仅当前项目）
cd /path/to/your-project mkdir -p .clinerules unzip my-skill.zip -d .clinerules/
Windows · 工作区安装（仅当前项目）
cd C:\path\to\your-project mkdir .clinerules Expand-Archive my-skill.zip -DestinationPath .\.clinerules
跨工具兼容： Cline 会自动识别项目根目录的 .cursorrules、.windsurfrules、AGENTS.md，并读取全局 ~/.agents/AGENTS.md。安装后新开对话即可生效，无需重启 VS Code。

遇到问题？

若安装后技能未被识别，请逐项检查：

  • ZIP 解压后顶层是否为技能目录（而非直接散落 SKILL.md 文件）
  • 技能目录内是否存在 SKILL.md（文件名必须为此，区分大小写）
  • 路径中的 ~（Mac/Linux）或 %USERPROFILE%（Windows）是否正确展开为用户目录
  • 客户端是否需要重启或新开对话以重新扫描技能目录
  • Windows 用户：确认在 PowerShell 中执行命令（CMD 不支持 Expand-Archive）
  • 项目级技能不生效时，检查是否进入了正确的项目根目录