# vision

Sends images to an external vision model when your coding agent lacks native image understanding. Handles OCR, screenshots, and diagrams via a local helper script.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 13400 installs · ★ 3
- Author: kotot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kotot/vision/tree/HEAD/vision/SKILL.md
- Updated: 2026-07-02
- HTML: https://affpapa.org/en/nevibecode/skills/vision

## What it does

This skill bridges the gap when an agent cannot view images directly. It supplies a bundled Python script, `scripts/see.py`, which packages the target image and your prompt into an API call. The external model then returns a plain text response to standard output.

The script relies solely on the Python standard library without extra dependencies. Setup requires two environment variables: `VISION_BASE_URL` pointing to the full chat completions endpoint and `VISION_MODEL` indicating the chosen model. You can store them in shell variables or in `.claude/settings.json`.

Local server setups can skip `VISION_API_KEY`. If you need to verify what gets sent, run the script with `--dry-run` to inspect the payload. Without a reachable completions endpoint, every execution fails immediately.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add kotot/vision --skill vision -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/vision/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/vision/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add kotot/vision --skill vision -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/vision/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add kotot/vision --skill vision -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/vision/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kotot/vision vision
```

2. **Manually: put the files in place**
- File: `.github/skills/vision/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add kotot/vision --skill vision -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/kotot/vision --path vision
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vision/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add kotot/vision --skill vision -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/kotot/vision/tree/HEAD/vision/SKILL.md

## When to use it
- extract text and tables from scanned documents or receipts
- diagnose errors shown in terminal or browser screenshots
- interpret architecture diagrams and user interface mockups
- convert chart values into structured markdown tables

## Example prompts
- Inspect error.png and explain why the build failed
- Transcribe the text from receipt.png preserving the original structure
- Examine diagram.png and describe the components shown

## Similar
- [qianwen-vision](https://affpapa.org/en/nevibecode/skills/qianwen-vision.md) — skill · 5700 installs
- [vision-multimodal](https://affpapa.org/en/nevibecode/skills/vision-multimodal.md) — skill · 550 installs
- [qwencloud-vision](https://affpapa.org/en/nevibecode/skills/qwencloud-vision.md) — skill · 1800 installs
- [vision-analysis](https://affpapa.org/en/nevibecode/skills/vision-analysis.md) — skill · 2700 installs
- [configuring-vision](https://affpapa.org/en/nevibecode/skills/configuring-vision.md) — skill · 496 installs
- [vision-framework](https://affpapa.org/en/nevibecode/skills/vision-framework.md) — skill · 3800 installs

## Other versions with the same name
- [vision · kunchenguid](https://affpapa.org/en/nevibecode/skills/kunchenguid-vision.md) — 666 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md