From e5e88b8067bc24fd85b4b14af42b80df7ba4033a Mon Sep 17 00:00:00 2001 From: Mark McDonald Date: Thu, 13 Aug 2026 14:57:19 +0800 Subject: [PATCH 1/2] feat: update skills for gemini-3.7-flash --- plugin.json | 2 +- skills/gemini-api-dev/SKILL.md | 10 ++++---- skills/gemini-interactions-api/SKILL.md | 24 +++++++++--------- .../references/migration.md | 25 ++++++++++--------- 4 files changed, 31 insertions(+), 30 deletions(-) diff --git a/plugin.json b/plugin.json index 8621e25..f2099e5 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "gemini-skills", - "version": "1.0.0", + "version": "1.1.0", "description": "A library of skills for the Gemini API, SDK and model interactions.", "author": { "name": "Google" diff --git a/skills/gemini-api-dev/SKILL.md b/skills/gemini-api-dev/SKILL.md index b5b3874..76fa0f5 100644 --- a/skills/gemini-api-dev/SKILL.md +++ b/skills/gemini-api-dev/SKILL.md @@ -12,7 +12,7 @@ description: Use this skill when building applications with Gemini API hosted mo ### Current Models (Use These) -- `gemini-3.6-flash`: 1M tokens, fast, balanced performance for agentic and multimodal tasks +- `gemini-3.7-flash`: 1M tokens, fast, balanced performance for agentic and multimodal tasks - `gemini-3.5-flash-lite`: 1M tokens, fastest, lowest-cost 3.5 model for high-throughput execution - `gemini-3.1-pro-preview`: 1M tokens, complex reasoning, coding, research - `gemini-3-pro-image-preview` (Nano Banana Pro): 65k / 32k tokens, image generation and editing @@ -46,7 +46,7 @@ from google import genai client = genai.Client() response = client.models.generate_content( - model="gemini-3.6-flash", + model="gemini-3.7-flash", contents="Explain quantum computing" ) print(response.text) @@ -58,7 +58,7 @@ import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); const response = await ai.models.generateContent({ - model: "gemini-3.6-flash", + model: "gemini-3.7-flash", contents: "Explain quantum computing" }); console.log(response.text); @@ -82,7 +82,7 @@ func main() { log.Fatal(err) } - resp, err := client.Models.GenerateContent(ctx, "gemini-3.6-flash", genai.Text("Explain quantum computing"), nil) + resp, err := client.Models.GenerateContent(ctx, "gemini-3.7-flash", genai.Text("Explain quantum computing"), nil) if err != nil { log.Fatal(err) } @@ -102,7 +102,7 @@ public class GenerateTextFromTextInput { Client client = new Client(); GenerateContentResponse response = client.models.generateContent( - "gemini-3.6-flash", + "gemini-3.7-flash", "Explain quantum computing", null); diff --git a/skills/gemini-interactions-api/SKILL.md b/skills/gemini-interactions-api/SKILL.md index 1c09916..fd6b2f5 100644 --- a/skills/gemini-interactions-api/SKILL.md +++ b/skills/gemini-interactions-api/SKILL.md @@ -12,7 +12,7 @@ description: Use this skill when writing code that calls the Gemini API for text ### Current Models (Use These) -- `gemini-3.6-flash`: 1M tokens, fast, balanced performance for agentic and multimodal tasks +- `gemini-3.7-flash`: 1M tokens, fast, balanced performance for agentic and multimodal tasks - `gemini-3.5-flash-lite`: 1M tokens, fastest, lowest-cost 3.5 model for high-throughput execution - `gemini-3.1-pro-preview`: 1M tokens, complex reasoning, coding, research - `gemini-3.1-flash-lite`: cost-efficient, fastest performance for high-frequency, lightweight tasks @@ -26,7 +26,7 @@ description: Use this skill when writing code that calls the Gemini API for text > [!WARNING] > Models like `gemini-2.5-*`, `gemini-2.0-*`, `gemini-1.5-*` are **legacy and deprecated**. Never use them. -> **If a user asks for a deprecated model, use `gemini-3.6-flash` instead and note the substitution.** +> **If a user asks for a deprecated model, use `gemini-3.7-flash` instead and note the substitution.** ### Current Agents @@ -53,7 +53,7 @@ description: Use this skill when writing code that calls the Gemini API for text - **Managed agents** require `environment="remote"` (or an environment ID / config object) to provision a sandbox. - **Migrating from `generateContent`**: Read `references/migration.md` for the scoping, checklist, and before/after code examples. Always confirm scope with the user before editing. - **Model upgrades**: Drop-in, swap the model string. Deprecated models (`gemini-2.0-*`, `gemini-1.5-*`) must be replaced, see `references/migration.md`. -- **Migrating to Gemini 3.6 Flash or Gemini 3.5 Flash-Lite**: Read `references/migration.md` for the scoping and checklist. +- **Migrating to Gemini 3.7 Flash or Gemini 3.5 Flash-Lite**: Read `references/migration.md` for the scoping and checklist. ## Quick Start @@ -64,7 +64,7 @@ from google import genai client = genai.Client() interaction = client.interactions.create( - model="gemini-3.6-flash", + model="gemini-3.7-flash", input="Tell me a short joke about programming." ) print(interaction.output_text) @@ -77,7 +77,7 @@ import { GoogleGenAI } from "@google/genai"; const client = new GoogleGenAI({}); const interaction = await client.interactions.create({ - model: "gemini-3.6-flash", + model: "gemini-3.7-flash", input: "Tell me a short joke about programming.", }); console.log(interaction.output_text); @@ -98,12 +98,12 @@ The SDK provides convenience properties on the `Interaction` response object to ### Python ```python interaction1 = client.interactions.create( - model="gemini-3.6-flash", + model="gemini-3.7-flash", input="Hi, my name is Phil." ) # Second turn — server remembers context interaction2 = client.interactions.create( - model="gemini-3.6-flash", + model="gemini-3.7-flash", input="What is my name?", previous_interaction_id=interaction1.id ) @@ -113,11 +113,11 @@ print(interaction2.output_text) ### JavaScript/TypeScript ```typescript const interaction1 = await client.interactions.create({ - model: "gemini-3.6-flash", + model: "gemini-3.7-flash", input: "Hi, my name is Phil.", }); const interaction2 = await client.interactions.create({ - model: "gemini-3.6-flash", + model: "gemini-3.7-flash", input: "What is my name?", previous_interaction_id: interaction1.id, }); @@ -283,7 +283,7 @@ Set `stream=True` to receive incremental server-sent events. Each stream follows ### Python ```python for event in client.interactions.create( - model="gemini-3.6-flash", + model="gemini-3.7-flash", input="Explain quantum entanglement in simple terms.", stream=True, ): @@ -297,7 +297,7 @@ for event in client.interactions.create( ### JavaScript/TypeScript ```typescript const stream = await client.interactions.create({ - model: "gemini-3.6-flash", + model: "gemini-3.7-flash", input: "Explain quantum entanglement in simple terms.", stream: true, }); @@ -367,7 +367,7 @@ For streaming with tools, thinking, agents, and image generation see the full [S - [Deep Research](https://ai.google.dev/gemini-api/docs/interactions/deep-research.md.txt) **Advanced Features:** -- [Latest Models (3.6 Flash & 3.5 Flash-Lite)](https://ai.google.dev/gemini-api/docs/latest-model.md.txt) +- [Latest Models (3.7 Flash & 3.5 Flash-Lite)](https://ai.google.dev/gemini-api/docs/latest-model.md.txt) - [Flex Inference](https://ai.google.dev/gemini-api/docs/interactions/flex-inference.md.txt) - [Priority Inference](https://ai.google.dev/gemini-api/docs/interactions/priority-inference.md.txt) diff --git a/skills/gemini-interactions-api/references/migration.md b/skills/gemini-interactions-api/references/migration.md index 32ab149..2da597d 100644 --- a/skills/gemini-interactions-api/references/migration.md +++ b/skills/gemini-interactions-api/references/migration.md @@ -18,7 +18,7 @@ Even imperative requests like "migrate my code", "upgrade to gemini 3", "migrate **Sizing the scope (large repos).** Before asking, get a per-directory count: ```sh -rg -l "generate_content\|generateContent\|gemini-2\.0\|gemini-1\.5\|gemini-2\.5\|gemini-3\.5\|gemini-3\.6\|thinking_budget\|temperature" --type-not md | cut -d/ -f1 | sort | uniq -c | sort -rn +rg -l "generate_content\|generateContent\|gemini-2\.0\|gemini-1\.5\|gemini-2\.5\|gemini-3\.5\|gemini-3\.6\|gemini-3\.7\|thinking_budget\|temperature" --type-not md | cut -d/ -f1 | sort | uniq -c | sort -rn ``` Present the breakdown in your question (e.g. *"Found 42 references across 3 directories: src/ (28), tests/ (10), scripts/ (4). Which to migrate?"*). @@ -50,17 +50,17 @@ For full before/after code examples, fetch the [Migration Guide](https://ai.goog | Model | Status | Drop-in Replacement | |-------|--------|-------------------| -| `gemini-2.0-flash` | Deprecated | `gemini-3.6-flash` | +| `gemini-2.0-flash` | Deprecated | `gemini-3.7-flash` | | `gemini-2.0-flash-lite` | Deprecated | `gemini-3.5-flash-lite` | -| `gemini-1.5-pro` | Deprecated | `gemini-3.6-flash` | -| `gemini-1.5-flash` | Deprecated | `gemini-3.6-flash` | +| `gemini-1.5-pro` | Deprecated | `gemini-3.7-flash` | +| `gemini-1.5-flash` | Deprecated | `gemini-3.7-flash` | ### Active Legacy Models (migration recommended) | Current Model | Recommended Target | Why | |--------------|-------------------|-----| -| `gemini-3.5-flash` or `gemini-3-flash-preview` | `gemini-3.6-flash` | Latest Flash: stronger agentic/multimodal performance, reduced token usage/loop spiraling | -| `gemini-2.5-flash` | `gemini-3.6-flash` or `gemini-3.5-flash-lite` | Latest Flash with Interactions API support, or latest Flash-Lite for cheaper/simpler tasks. | +| `gemini-3.6-flash`, `gemini-3.5-flash`, or `gemini-3-flash-preview` | `gemini-3.7-flash` | Latest Flash: stronger agentic/multimodal performance, reduced token usage/loop spiraling | +| `gemini-2.5-flash` | `gemini-3.7-flash` or `gemini-3.5-flash-lite` | Latest Flash with Interactions API support, or latest Flash-Lite for cheaper/simpler tasks. | | `gemini-2.5-flash-lite` or `gemini-3.1-flash-lite` | `gemini-3.5-flash-lite` | Latest Flash-lite with Interactions API support | | `gemini-2.5-pro` | `gemini-3.1-pro-preview` | Latest Pro with 1M context, complex reasoning | @@ -91,18 +91,19 @@ Every item is tagged: **`[BLOCKS]`** items cause errors or broken behavior if mi - [ ] Replaced `gemini-2.0-*` model strings with current equivalents - [ ] Replaced `gemini-1.5-*` model strings with current equivalents -- [ ] Consider upgrading `gemini-3.5-flash` → `gemini-3.6-flash` -- [ ] Consider upgrading `gemini-3-flash-preview` → `gemini-3.6-flash` -- [ ] Consider upgrading `gemini-2.5-flash` → `gemini-3.6-flash` +- [ ] Consider upgrading `gemini-3.6-flash` → `gemini-3.7-flash` +- [ ] Consider upgrading `gemini-3.5-flash` → `gemini-3.7-flash` +- [ ] Consider upgrading `gemini-3-flash-preview` → `gemini-3.7-flash` +- [ ] Consider upgrading `gemini-2.5-flash` → `gemini-3.7-flash` - [ ] Consider upgrading `gemini-3.1-flash-lite` → `gemini-3.5-flash-lite` - [ ] Consider upgrading `gemini-2.5-flash-lite` → `gemini-3.5-flash-lite` or `gemini-3.1-flash-lite` - [ ] Consider upgrading `gemini-2.5-pro` → `gemini-3.1-pro-preview` -### Migrate to Gemini 3.6 Flash or Gemini 3.5 Flash-Lite +### Migrate to Gemini 3.7 Flash or Gemini 3.5 Flash-Lite -Use this checklist if the user requests to migrate to Gemini 3.6 Flash or Gemini 3.5 Flash-Lite. For full documentation of the changes, fetch the [Latest Gemini models guide](https://ai.google.dev/gemini-api/docs/latest-model.md.txt) and look for the migration section. +Use this checklist if the user requests to migrate to Gemini 3.7 Flash or Gemini 3.5 Flash-Lite. For full documentation of the changes, fetch the [Latest Gemini models guide](https://ai.google.dev/gemini-api/docs/latest-model.md.txt) and look for the migration section. -- [ ] Updated model name to `gemini-3.6-flash` or `gemini-3.5-flash-lite` (depending on user request) +- [ ] Updated model name to `gemini-3.7-flash` or `gemini-3.5-flash-lite` (depending on user request) - [ ] Removed `temperature`, `top_p`, `top_k` from config - [ ] Replaced `thinking_budget` with `thinking_level` (`minimal`, `low`, `medium`, `high`) From 16c3b6772801bc338da5e7d38e773eb13a37f723 Mon Sep 17 00:00:00 2001 From: Mark McDonald Date: Fri, 14 Aug 2026 01:11:13 +0800 Subject: [PATCH 2/2] fix: ripgrep escaping Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- skills/gemini-interactions-api/references/migration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/gemini-interactions-api/references/migration.md b/skills/gemini-interactions-api/references/migration.md index 2da597d..eff0992 100644 --- a/skills/gemini-interactions-api/references/migration.md +++ b/skills/gemini-interactions-api/references/migration.md @@ -18,7 +18,7 @@ Even imperative requests like "migrate my code", "upgrade to gemini 3", "migrate **Sizing the scope (large repos).** Before asking, get a per-directory count: ```sh -rg -l "generate_content\|generateContent\|gemini-2\.0\|gemini-1\.5\|gemini-2\.5\|gemini-3\.5\|gemini-3\.6\|gemini-3\.7\|thinking_budget\|temperature" --type-not md | cut -d/ -f1 | sort | uniq -c | sort -rn +rg -l "generate_content|generateContent|gemini-2\.0|gemini-1\.5|gemini-2\.5|gemini-3\.5|gemini-3\.6|gemini-3\.7|thinking_budget|temperature" --type-not md | cut -d/ -f1 | sort | uniq -c | sort -rn ``` Present the breakdown in your question (e.g. *"Found 42 references across 3 directories: src/ (28), tests/ (10), scripts/ (4). Which to migrate?"*).