Gemini Image Analysis (Bun + TypeScript)
When to use
Use this Skill when you need to analyze one or multiple images (screenshots, photos, diagrams) with Gemini Flash via the REST API.
Quick start
GEMINI_API_KEY="YOUR_KEY"
bun .claude/skills/gemini-image-analysis/scripts/gemini-image-analyze.ts
--prompt "Caption this image."
/path/to/image.jpg
macOS Keychain (optional)
If you store GEMINI_API_KEY in the macOS Keychain:
GEMINI_API_KEY="$(security find-generic-password -a "$(whoami)" -s "GEMINI_API_KEY" -w)"
bun .claude/skills/gemini-image-analysis/scripts/gemini-image-analyze.ts
--prompt "Caption this image."
/path/to/image.jpg
Multiple images
Send multiple images in one request (useful for comparison or “before/after”):
GEMINI_API_KEY="YOUR_KEY"
bun .claude/skills/gemini-image-analysis/scripts/gemini-image-analyze.ts
--prompt "Compare these images and describe the differences."
/path/to/image1.jpg
/path/to/image2.png
Options
-
--prompt <text> : Text instruction for the model (default: Caption this image. )
-
--model <model> : Model name (default: gemini-3-flash-preview )
-
--json : Print the full JSON response instead of extracted text
Notes
-
The script reads GEMINI_API_KEY from the environment and never stores it.
-
Supported image types: .jpg , .jpeg , .png , .webp , .gif .