godot-agent-vision — Claude Code skill: agent vision for Godot
godot-agent-vision — a skill that gives agents eyes in Godot projects: cross-platform screenshot capture, WebP encoding, and visual review scored by a taste receptor system. Use when agents need to see UI, assets, or the editor.
LGPL-3.0 287 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a claude-codeWhat godot-agent-vision does
godot-agent-vision is a host-side Python toolkit for capturing and analysing visuals in Godot projects. The main tool is a CLI capture.py with modes for assets, screen regions, editor windows, and viewports. Each screenshot is encoded to WebP with a budget (default short-edge 512px) before being passed to the model — no raw PNG walls in context.
The core is Taste Receptor Atlas v2: a table of 237 micro-receptors across 13 families (hierarchy, contrast, typography×41, affordance, space, color, icons, composition, light, motion, anti-slop, originality, identity), scored 0–2 each. The agent loads only relevant reference docs (e.g., typography-sight.md for text, hier-contrast-receptors.md for layout), not all at once, and returns a zero-list with fixes keyed to receptor IDs.
For editor work, a temporary bridge — a @tool EditorPlugin — is staged to addons/_gdskills_agent_vision/, captures the viewport to PNG, encodes to WebP, and removes itself after. Critical: the bridge must not persist in the project, and .gdskills/ must be gitignored before first run.
What it helps with
- capture a screenshot of an asset or UI panel and deliver it to the agent as compressed WebP
- score interface quality by typography, contrast, and element placement
- inspect the 3D viewport of the editor without launching the game
- review layout and design without external tools
- automate visual QA at the agent level
Example prompts for the agent
- Capture the Godot window and score its typography against micro-receptors
- Grab
res://ui/iconsas a contact sheet and rate color and icon semantics - Inspect the editor viewport in 3D mode via the temporary bridge, then tear it down
How to install godot-agent-vision
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a claude-code2Manually: put the files in place
~/.claude/skills/godot-agent-vision/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-agent-vision/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a codex2Manually: put the files in place
.agents/skills/godot-agent-vision/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a cursor2Manually: put the files in place
.cursor/skills/godot-agent-vision/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-agent-vision2Manually: put the files in place
.github/skills/godot-agent-vision/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-agent-visionManually: put the files in place
.devin/skills/godot-agent-vision/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-agent-vision
How do I install godot-agent-vision in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a claude-code, then load ~/.claude/skills/godot-agent-vision/SKILL.md into the agent's context.
What does godot-agent-vision do?
It enables agents to capture screenshots of Godot UI, assets, and editor viewports across platforms, encode them to optimised WebP, and score visual quality against a taste receptor system (237 parameters spanning typography, hierarchy, motion, and more).
Why must I remove the temporary editor bridge?
The bridge is a temporary plugin staged to addons/_gdskills_agent_vision/ only for capture. If left behind, it pollutes the project and runs on next launch. After each use, the script automatically deletes it and restores plugin settings.