Isometric Grid Math
Use when converting between grid coordinates and screen pixels in a 2:1 isometric projection, including screen-to-grid for mouse picking.
Install
npx skills add 0xheycat/isometric-game-skills --skill isometric-grid-mathgit clone --depth 1 https://github.com/0xheycat/isometric-game-skills.git /tmp/isometric-game-skills
mkdir -p ~/.claude/skills
cp -r /tmp/isometric-game-skills/skills/isometric-grid-math ~/.claude/skills/isometric-grid-mathPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Isometric Grid Math ## Overview Every isometric bug eventually traces back to the coordinate transform. This skill gives the exact, tested grid<->screen formulas for a 2:1 projection so placement and picking are pixel-correct. ## When to Use - Tiles render in the wrong place or overlap. - Mouse clicks select the wrong tile. - You are starting a renderer and need the core transform. ## Process 1. Fix tile width W and height H (2:1 means W = 2*H). 2. grid->screen: screenX = (col - row) * (W/2); screenY = (col + row) * (H/2). 3. Add the world origin offset so (0,0) is where you want it on screen. 4. screen->grid (for picking): invert the transform using W and H. 5. Round screen->grid results to integer tile coords. 6. Validate round-trip: grid -> screen -> grid returns the original tile. 7. Document the anchor (tile top vs tile center) and stay consistent. ```js const screenX = (col - row) * (W / 2); const screenY = (col + row) * (H / 2); // inverse const col = ((screenX / (W/2)) + (screenY / (H/2))) / 2; const row = ((screenY / (H/2)) - (screenX / (W/2))) / 2; ``` ## Rationalizations (Stop Lying to Yourself) | Excuse | Reality | |---|---| | "I will tweak offsets until it looks right" | Magic offsets break on resize/zoom. Derive the transform. | | "Rounding does not matter" | Unrounded screen->grid selects the wrong tile near edges. Round it. | ## Red Flags - STOP if you catch yourself: - Hard-coded pixel offsets instead of a derived transform.
Details
- Skill name
isometric-grid-math- Repository
- 0xheycat/isometric-game-skills
- Path
skills/isometric-grid-math/SKILL.md- License
- MIT
- Repo updated
- 12 August 2026
- Listed in
- heilcheng/awesome-agent-skills
FAQ
What does the Isometric Grid Math skill do?
Use when converting between grid coordinates and screen pixels in a 2:1 isometric projection, including screen-to-grid for mouse picking.
How do I install the Isometric Grid Math skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add 0xheycat/isometric-game-skills --skill isometric-grid-math. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Isometric Grid Math popular?
It lives in 0xheycat/isometric-game-skills, which has 49 GitHub stars and 6 forks, and is included in 1 curated skill list.
Related skills
Animated Sprite Generation
490xheycat/isometric-game-skills
Use when creating looping animated isometric sprites (water, fire, windmills, flags) as frame strips that play back smoothly in-engine.
Asset Pipeline Automation
490xheycat/isometric-game-skills
Use when automating the path from generated sprites to a shipped atlas + map so re-generating art does not mean hours of manual rework.
Autotiling Transitions
490xheycat/isometric-game-skills
Use when making different terrain types (grass, water, sand) blend with automatic edge and corner transition tiles instead of hard seams.
Isometric Object Sprites
490xheycat/isometric-game-skills
Use when generating isolated isometric props (trees, rocks, bushes, stumps) that drop cleanly onto tiles with correct scale and a transparent background.
Isometric Character Sprites
490xheycat/isometric-game-skills
Use when generating isometric characters in consistent 8 directions with a fixed feet-anchor for movement and depth sorting.
Isometric Pathfinding
490xheycat/isometric-game-skills
Use when units must navigate an isometric grid around obstacles using A* on the walkable layer with correct iso neighbor rules.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.