如何在 Google Gemini CLI 中使用 Agent Skills？
一句话：Gemini CLI 是 Google 开源的终端 AI 编程 Agent（Apache 2.0），用 Google 账号登录就免费获得每分钟 60 次 Gemini 2.5 Pro 调用。技能写在项目根目录的 GEMINI.md，启动时自动加载。
什么是 Gemini CLI
Google 开源的命令行 AI 编程工具，和 Claude Code、Codex CLI 同类：读项目代码、编辑文件、执行命令、遵循 Markdown 指令。
核心特性：
- 免费额度：Google 账号登录，每分钟 60 次请求，无需 API Key——三大 CLI 中唯一有免费层的
- 开源：Apache 2.0
- Gemini 2.5 Pro：Google 最强编程模型
- 多模态：支持文本、图片、文件附件
安装
# 需要 Node.js 18+
npm install -g @google/gemini-cli
# 或免安装运行
npx @google/gemini-cli
# Google 账号登录
gemini auth login
# 需要更高频率时设置 API Key
export GEMINI_API_KEY="your-api-key-here"
# 验证
gemini --version
GEMINI.md：Gemini 的技能文件
按层级加载（类似 .gitignore）：
- 全局：
~/.gemini/GEMINI.md— 所有项目生效 - 项目根：
./GEMINI.md— 当前项目生效 - 子目录：
./src/GEMINI.md— 该目录下生效
# Project Instructions
You are working on a Nuxt 3 application with TypeScript.
## Code Style
- Use Composition API with `<script setup>`
- All components go in `components/`
## Testing
- Run `npm test` before committing
从 TokRepo 安装 Skill
方法 1：TokRepo CLI（推荐）
npm install -g tokrepo
tokrepo install <skill-uuid> --target gemini
--target gemini 会自动转换格式放进 .gemini/ 目录。
方法 2：手动安装
复制 Skill 的 Markdown 到 GEMINI.md，把 Claude Code 相关引用（如斜杠命令触发）换成自然语言调用。大部分指令（代码规范、测试规则、部署步骤）无需修改。
Gemini CLI 最佳 8 个 Skill
| # | Skill | 用途 |
|---|---|---|
| 1 | Stitch Extension | 终端内生成 UI 组件，应用 Design Token |
| 2 | Google Gemini CLI Extensions | 官方+社区扩展合集：文件搜索、网页浏览、代码沙箱 |
| 3 | Workspace Extension | 多项目工作区：切换仓库、独立上下文 |
| 4 | Get Shit Done (GSD) | 项目管理框架，.planning/ 跨会话追踪（三大 CLI 通用，48,600+ stars） |
| 5 | Vercel Skills | 13,000+ 社区 Skill，Next.js/React 全栈 |
| 6 | Claude SEO | 全面 SEO 审计（名字带 Claude 但任何 CLI 都能用） |
| 7 | Systematic Debugging | 结构化调试：假设→取证→隔离根因→修复验证 |
| 8 | Web Access | 抓取分析网页、API、在线文档 |
安装示例：tokrepo install e108cf5c --target gemini（GSD）。
三大 CLI 对比
| 特性 | Gemini CLI | Claude Code | Codex CLI |
|---|---|---|---|
| 开发商 | Anthropic | OpenAI | |
| 开源协议 | Apache 2.0 | 商业 | 开源 |
| 技能格式 | GEMINI.md | .claude/commands/*.md | AGENTS.md |
| 免费额度 | 60 次/分钟 | 有限 | 有限 |
| 多模态 | 支持（图片、文件） | 支持 | 仅文本 |
| 技能生态 | 成长中 | 最大（TokRepo） | 成长中 |
要点：Gemini CLI 胜在免费额度和 Google Cloud 集成；Claude Code 技能生态最成熟、复杂重构推理最强；Codex CLI 与 OpenAI 模型深度集成。三者技能都是 Markdown，TokRepo 上的 Skill 微调即可跨平台。
常见问题
Skill 能在三者间通用吗？
能。核心是 Markdown 指令，与模型无关，区别只是文件位置和触发语法。--target 参数自动处理转换。
真的免费吗？
CLI 开源免费，Google 账号即得 60 次/分钟，无需信用卡。高频使用另设 GEMINI_API_KEY 按量计费。
支持 MCP 吗？
通过 Extensions API 支持类 MCP 工具扩展，但原生 MCP 支持不如 Claude Code 成熟。大量外部工具集成目前优选 Claude Code。
适合哪些场景？
最适合：预算有限的学生和独立开发者、GCP/Firebase 技术栈、多模态需求。不适合：需要 10+ MCP Server 的复杂工作流或深度 OpenAI 生态。
怎么装社区 Skill？
下载 .md 重命名为 GEMINI.md 放项目根目录即可，也可在 GEMINI.md 里组合多个 Skill 内容。