gemini-skills快速上手教程：5分钟将Gemini API官方技能装进Claude Code、Cursor与Codex

gemini-skills快速上手教程：5分钟将Gemini API官方技能装进Claude Code、Cursor与Codex

【免费下载链接】gemini-skillsSkills for the Gemini API, SDK and model/agent interactions项目地址: https://gitcode.com/gh_mirrors/ge/gemini-skills

gemini-skills是 Google 出品的 Gemini API 官方技能库，一句话概括：它把「最新的模型版本、SDK 用法、API 最佳实践」打包成一份份Skills（技能文件），一键装进你的 AI 编程助手（Claude Code、Cursor、OpenAI Codex 等），让 AI 写出的 Gemini 代码不再过时。本教程带你 5 分钟内完成安装与上手。🚀

一、为什么需要 gemini-skills？

大模型的知识有截止日期，而 Gemini API 迭代飞快：模型不断改名、SDK 持续升级、旧接口陆续弃用。AI 助手如果凭"记忆"写代码，很容易：

• ❌ 调用已废弃的gemini-1.5-*、gemini-2.0-*老模型
• ❌ 安装早已停更的旧版 SDK
• ❌ 用旧接口generateContent而不是推荐的 Interactions API

Skills是一种轻量技术：以纯 Markdown 文件的形式，把"当前该用什么模型、该装什么 SDK、该怎么迁移"注入 AI 助手上下文。官方评测显示，装上技能后 AI 生成正确 API 代码的准确率最高可达96%（Gemini 3.1 Pro）。📈

💡 每个技能的核心文件就是 SKILL.md，里面开头就写着"这些规则覆盖你的训练数据，你的知识已过时"——直接告诉 AI 以技能内容为准。

二、仓库里的 4 个技能一览

插件元信息（版本 1.1.0、Apache-2.0 许可）见 plugin.json。

三、5分钟安装：按你的工具对号入座

1️⃣ Claude Code：两条命令搞定

在 Claude Code 对话框中依次执行：

/plugin marketplace add google-gemini/gemini-skills /plugin install gemini-skills@gemini-skills

2️⃣ Cursor：一条命令直接装

在 Cursor 中执行插件命令：

/add-plugin google-gemini/gemini-skills

3️⃣ OpenAI Codex：先加市场源再安装

codex plugin marketplace add https://gitcode.com/gh_mirrors/ge/gemini-skills codex plugin install gemini-skills

4️⃣ 通用 CLI：不想开编辑器？

也可以用命令行工具交互式浏览并挑选安装：

npx skills add google-gemini/gemini-skills --list npx ctx7 skills install /google-gemini/gemini-skills

安装完成后，你在 Claude Code / Cursor / Codex 里随口说一句"帮我写个调用 Gemini 的脚本"，AI 就会自动加载对应技能，输出使用gemini-3.7-flash新模型 +google-genai新 SDK 的代码，而不是训练数据里的老写法。✨

四、上手后能得到什么？举三个例子

🧠 例1：写多轮对话代码gemini-interactions-api技能会引导 AI 使用client.interactions.create()加previous_interaction_id实现服务端记忆的多轮对话，并附上output_text、output_image等便捷属性说明，避免你翻遍文档。

🎙️ 例2：搭实时语音助手gemini-live-api-dev技能覆盖了 WebSocket 连接、语音活动检测（VAD）、临时令牌鉴权、实时翻译（70+ 语言）与转写，还贴心列出了"测试麦克风请戴耳机防自打断"这类最佳实践。

🎬 例3：AI 视频生成gemini-omni-flash-api技能自带可执行脚本，覆盖文生视频、首尾帧过渡、视频延长（最长 40s）与风格编辑：

• generate_video.py — 端到端生成并下载视频
• prep_video.py — 用 ffmpeg 预处理/裁剪长视频
• inspect_video.py — 查看视频时长、分辨率、帧率
• upload_file.py — 上传素材到 Files API

⚠️ 小提醒：使用视频编辑前，记得设置GEMINI_API_KEY环境变量，并安装ffmpeg。

五、老项目怎么迁移？技能内置迁移清单

如果你的项目还在用旧的generateContent接口，gemini-interactions-api技能内置了完整的迁移参考 migration.md，包含：

• generateContent→Interactions的逐行对照表
• 已废弃模型替换表（如gemini-1.5-pro→gemini-3.7-flash）
• 带[BLOCKS]/[TUNE]标签的迁移检查清单

直接对 AI 说"按技能里的迁移清单帮我升级这个文件"，它会先和你确认迁移范围再动手，安全又省心。🔧

六、常见问题速答

Q1：装了技能后 AI 就永远正确吗？技能保证模型名和 SDK 版本是当前最新的，但具体参数细节仍建议让 AI 联网核对官方文档，技能中已内置文档检索指引。

Q2：技能会不会让对话变慢？Skills 是按需加载的 Markdown 上下文，体积小巧，几乎不增加延迟，反而减少了 AI 翻文档的 token 消耗。

Q3：它和 MCP 是什么关系？可以共存。技能负责"教 AI 正确的姿势"，MCP 负责"给 AI 查最新文档的工具"，配合使用效果最佳。

写在最后

gemini-skills 是目前最省心的"AI 编程助手外挂"：不写一行配置，5 分钟安装，让你的 Claude Code、Cursor、Codex 立刻学会最新的 Gemini API 开发姿势。快去试试吧！🎉

【免费下载链接】gemini-skillsSkills for the Gemini API, SDK and model/agent interactions项目地址: https://gitcode.com/gh_mirrors/ge/gemini-skills