Files
firefrost-operations-manual/docs/skills/gemini-tools/README.md
Claude 75a1fd6aa5 feat(skills): Add gemini-tools collection
- gemini-consultant: Second opinion with web search + vision
- gemini-second-opinion: Independent technical analysis
- gemini-image-generation: AI image generation (nano-banana CLI)
- Includes consult.py script
- Complements existing gemini-consultation skill
- Updated SKILLS-INDEX.md

Chronicler #73
2026-04-09 13:14:32 +00:00

124 lines
3.3 KiB
Markdown

# 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** 💙🔥❄️