Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion plugin.json
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
10 changes: 5 additions & 5 deletions skills/gemini-api-dev/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand All @@ -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);
Expand All @@ -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)
}
Expand All @@ -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);

Expand Down
24 changes: 12 additions & 12 deletions skills/gemini-interactions-api/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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

Expand All @@ -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

Expand All @@ -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)
Expand All @@ -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);
Expand All @@ -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
)
Expand All @@ -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,
});
Expand Down Expand Up @@ -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,
):
Expand All @@ -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,
});
Expand Down Expand Up @@ -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)

Expand Down
25 changes: 13 additions & 12 deletions skills/gemini-interactions-api/references/migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Comment thread
markmcd marked this conversation as resolved.
Outdated
```

Present the breakdown in your question (e.g. *"Found 42 references across 3 directories: src/ (28), tests/ (10), scripts/ (4). Which to migrate?"*).
Expand Down Expand Up @@ -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 |

Expand Down Expand Up @@ -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`)

Expand Down