Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
```

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