# Gemini Vision

> Use when inspecting or reviewing UI screenshots, mockups, diagrams, or wireframes for layout, hierarchy, readability, or visual bugs. Not for pixel or color analysis of camera or capture images, nor for routine text edits.

- Skill: `calvin-llc/gemini-vision` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add calvin-llc/gemini-vision`
- Raw SKILL.md: https://api.skillmd.com/api/skills/calvin-llc/gemini-vision/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: Calvin-LLC (https://skillmd.com/u/calvin-llc)
- Updated: 2026-11-17
- Page: https://skillmd.com/skills/calvin-llc/gemini-vision

---


# Visual inspection and review (`gemini-vision`)

Inspect rendered interfaces, mockups, and wireframes with a multimodal vision model. Use when auditing visual hierarchy, confirming UI bug fixes, reading complex diagrams, or transcribing wireframes. For pixel or color analysis of camera or capture images, read the image directly or script it instead.

## Workflow

1. **Capture or locate image**:
   - Web application: capture a full-page or element screenshot with a headless-browser or screenshot tool.
   - Local mockup / wireframe / diagram: use the local file path.

2. **Inspect and label**:
   ```bash
   node <skill-dir>/review.mjs <image-path>
   ```

   To use a custom prompt, model, or OpenAI-compatible endpoint:
   ```bash
   node <skill-dir>/review.mjs <image-path> --prompt "Label all buttons, inputs, and form sections in this mockup" --model "gemini-2.5-flash"
   ```

   `review.mjs` needs `VISION_API_KEY`, `OPENAI_API_KEY`, or `GEMINI_API_KEY` in the environment (or in `.env` or `.config/vision/env` under the home directory). `VISION_BASE_URL` and `VISION_MODEL` are optional. If no key is set, stop and ask the user to provide one. Do not invent review results. Set variables for one run like this:
   ```
   POSIX:                GEMINI_API_KEY=<key> node <skill-dir>/review.mjs <image-path>
   Windows (PowerShell): $env:GEMINI_API_KEY='<key>'; node <skill-dir>/review.mjs <image-path>
   ```

3. **Verify contrast deterministically**:
   Vision models approximate; never trust raw color numbers from a model. If the inspection flags potential contrast issues, test the hex pair directly:
   ```bash
   node <skill-dir>/wcag.mjs "#FOREGROUND" "#BACKGROUND"
   ```

4. **Iterate**:
   Make code changes, re-capture the screenshot, and run a second review to confirm resolution. Cap review cycles at two passes. If the second pass still fails, report what remains to the user.

## Diagram and wireframe transcription

When analyzing photographed whiteboard wireframes or rough sketches:
- Ask specifically for component bounds, text transcriptions, and visual hierarchy.
- Identify primary focal elements before inspecting secondary navigation.
- Flag any ambiguous gestures or handwritten text for human confirmation.

