# Gemini Tools Collection

Skills for integrating Google Gemini into Firefrost workflows.

**Requirement:** `GEMINI_API_KEY` environment variable must be set.  
**API Key:** https://aistudio.google.com/app/apikey

---

## Available Tools

| Tool | File | Purpose |
|------|------|---------|
| Gemini Consultant | `gemini-consultant.md` | Second opinion with web search + vision |
| Gemini Second Opinion | `gemini-second-opinion.md` | Independent technical analysis |
| Gemini Image Generation | `gemini-image-generation.md` | AI image generation with nano-banana CLI |

---

## Gemini Consultant

**Best for:** Real-time web information, fact verification, image analysis

```bash
# With web search (default)
uv run consult.py "What's the latest NeoForge version?"

# With context
uv run consult.py "What could cause this error?" -c "TypeError: Cannot read property 'map' of undefined"

# Analyze an image
uv run consult.py "What's in this image?" -i screenshot.png

# Without web search
uv run consult.py "Explain the CAP theorem" --no-search
```

**Python script included:** `consult.py`

---

## Gemini Second Opinion

**Best for:** Architectural decisions, code reviews, plan validation

```bash
gemini "REVIEW MODE: [your question]" --output-format json
```

**Use cases:**
- Validate a plan before executing
- Cross-check Claude's analysis
- Architecture decisions (GraphQL vs REST, microservices vs monolith)
- Security assessment validation

---

## Gemini Image Generation (Nano Banana)

**Best for:** Generating images, thumbnails, marketing assets

```bash
# Generate image
gemini-nano-banana-tool generate "A cat wearing a wizard hat" -o cat.png

# AI-optimize prompt first
gemini-nano-banana-tool promptgen "wizard cat" | gemini-nano-banana-tool generate -o cat.png -s

# Different aspect ratios
gemini-nano-banana-tool generate "YouTube thumbnail" -o thumb.png -a 16:9
gemini-nano-banana-tool generate "Instagram story" -o story.png -a 9:16
```

**Cost estimates:**
- Flash: ~$0.039/image
- Pro 1K/2K: ~$0.134/image
- Pro 4K: ~$0.24/image

---

## Firefrost Integration

### Existing Workflow
Our `gemini-consultation` skill already provides structured consultation patterns.
These tools complement it with:

1. **Real-time web search** — Verify latest versions, docs, news
2. **Independent analysis** — "Two AI perspectives catch more issues than one"
3. **Image generation** — Marketing assets, thumbnails, social media graphics

### When to Use Each

| Situation | Tool |
|-----------|------|
| Need current info (versions, docs) | Gemini Consultant |
| Validate architecture decisions | Gemini Second Opinion |
| Review Claude's security analysis | Gemini Second Opinion |
| Create marketing graphics | Gemini Image Generation |
| Generate thumbnails/banners | Gemini Image Generation |
| Structured consultation with handoff | `gemini-consultation` skill |

---

## Setup

1. Get API key: https://aistudio.google.com/app/apikey
2. Set environment variable:
   ```bash
   export GEMINI_API_KEY='your-api-key'
   ```
3. For nano-banana tool:
   ```bash
   git clone https://github.com/dnvriend/gemini-nano-banana-tool.git
   cd gemini-nano-banana-tool
   uv tool install .
   ```

---

**Source:** skill.fish (melodic-software, stared, dnvriend)  
**Added:** 2026-04-09 by Chronicler #73

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
