Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-agent-vision -a claude-code
Open on GitHub

What 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/icons as 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-code

2Manually: put the files in place

~/.claude/skills/godot-agent-vision/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-agent-vision/

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.

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set100

The whole set →
godot-genre-romance godot-genre-romance is a Claude Code skill for structuring Godot dating sims with multi-axis relationship stats, story branching, and NPC schedules. CX Codex +1 304installs godot-genre-sports godot-genre-sports sports game blueprints for Godot covering ball physics, Magnus curve forces, team formation AI, and match referee state machines. CX Codex +1 301installs godot-genre-shooter-fps godot-genre-shooter-fps — a Godot FPS skill covering mouse look, movement physics, hitscan fire, recoil, weapon motion, and server-checked hit handling. CX Codex +1 296installs godot-game-loop-time-trial godot-game-loop-time-trial is a Claude Code skill for Godot 4 racing trials, with ordered checkpoint validation, lap timing, and ghost playback. CX Codex +1 294installs godot-monte-carlo-balancer The godot-monte-carlo-balancer skill audits Godot balance with Monte Carlo simulations, economy checks, and parameter search. Use it to find unfair levels, farm exploits, and curve problems. CX Codex +1 268installs godot-builder godot-builder is a Claude Code skill that automates Godot CLI workflows for scene creation, 3D asset processing, and CI exports, including headless tasks. CX Codex +1 268installs godot-ai-navigation godot-ai-navigation is a skill that helps choose Godot navigation architecture for agents, including enemies and crowds. CX Codex +1 242installs godot-analyst The godot-analyst skill reviews Godot 4.7+ architecture, dependency structure, and scalability, then turns the findings into a scored certification. CX Codex +1 242installs

Project sponsors

Companies that keep this analytics open