完整指南：如何为 AI 编程工具安装 Skills

Skills 是扩展 AI 编程助手功能的专业能力插件。本指南涵盖了所有支持 Agent Skills 开放标准的主流 AI 编程工具的完整安装流程。

快速对比

工具	安装方式	命令示例
Claude Code	Git 克隆 + 插件系统	git clone <repo> ~/.claude/skills/skill-name 或 /plugin add user/repo
Codex	内置技能安装器	$skill-installer install from https://github.com/user/repo
Gemini CLI	Git 克隆（需启用实验功能）	git clone <repo> ~/.gemini/skills/skill-name
Antigravity	Git 克隆	git clone <repo> ~/.gemini/antigravity/skills/skill-name
OpenCode	Git 克隆（原生支持）	git clone <repo> ~/.config/opencode/skill/skill-name

详细安装指南

1. Claude Code

Claude Code 提供多种安装方式：

# 方法 1：直接克隆
git clone https://github.com/user/repo.git ~/.claude/skills/skill-name

# 方法 2：通过插件系统
/plugin add user/repo

# 方法 3：插件市场
/plugin marketplace add user/repo
/plugin install skill-name

2. Codex

Codex 拥有内置的技能安装器：

# 基本安装
$skill-installer install from https://github.com/user/repo

# 私有仓库安装（需要 GITHUB_TOKEN）
export GITHUB_TOKEN=your_token
$skill-installer install from https://github.com/user/private-repo

3. Gemini CLI

Gemini CLI 需要先启用实验功能：

# 第一步：安装 nightly 版本
npm install -g @google/gemini-cli@nightly

# 第二步：启用 Skills 功能（在 CLI 中执行）
gemini
/settings
# 开启 experimental.skills

# 第三步：克隆技能到指定目录
git clone https://github.com/user/repo.git ~/.gemini/skills/skill-name

4. Antigravity

Antigravity 支持工作区和全局级别的安装：

# 工作区级别
git clone https://github.com/user/repo.git .agent/skills/skill-name

# 全局级别
git clone https://github.com/user/repo.git ~/.gemini/antigravity/skills/skill-name

5. OpenCode

OpenCode 提供灵活的安装选项：

# 项目级安装（推荐）
git clone https://github.com/user/repo.git .opencode/skill/skill-name

# 全局安装
git clone https://github.com/user/repo.git ~/.config/opencode/skill/skill-name

# Claude 兼容路径（项目级）
git clone https://github.com/user/repo.git .claude/skills/skill-name

# Claude 兼容路径（全局）
git clone https://github.com/user/repo.git ~/.claude/skills/skill-name

Skills 目录结构

所有工具都遵循 Agent Skills 开放标准。技能目录应包含：

skill-name/
├── SKILL.md          # 必需：技能定义文件
├── README.md         # 可选：说明文档
├── skill.js          # 可选：技能实现
├── config.json       # 可选：配置文件
└── lib/              # 可选：依赖库

SKILL.md 文件是任何技能的核心，定义了：

• 何时触发技能
• 提供哪些功能
• 如何执行技能逻辑

权限配置（OpenCode）

OpenCode 允许在 opencode.json 中进行细粒度的权限控制：

{
  "permissions": {
    "skill": {
      "internal-*": "deny",
      "public-*": "allow",
      "*": "ask"
    }
  }
}

快速参考

对于 GitHub 仓库 https://github.com/example/my-skill：

# Claude Code
git clone https://github.com/example/my-skill.git ~/.claude/skills/my-skill

# Codex
$skill-installer install from https://github.com/example/my-skill

# Gemini CLI
git clone https://github.com/example/my-skill.git ~/.gemini/skills/my-skill

# Antigravity
git clone https://github.com/example/my-skill.git ~/.gemini/antigravity/skills/my-skill

# OpenCode
git clone https://github.com/example/my-skill.git ~/.config/opencode/skill/my-skill

发现更多 Skills

在我们的 Skills 目录 中浏览和发现社区贡献的技能。您可以找到各种用例的技能，包括：

• 网页抓取和自动化
• 代码生成和重构
• 数据处理和分析
• API 集成
• 更多精彩内容！

总结

一旦了解了每个工具的约定，为 AI 编程助手安装技能就变得非常简单。Agent Skills 开放标准确保了跨平台的兼容性，使开发者社区能够轻松共享和复用技能。

立即开始探索可用的技能，提升您的 AI 编程工作流程！