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.

49 stars 6 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add 0xheycat/isometric-game-skills --skill isometric-grid-math
Manual install
git 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-math

Personal 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.
Read the full skill on GitHub

Details

Skill name
isometric-grid-math
Path
skills/isometric-grid-math/SKILL.md
License
MIT
Repo updated
12 August 2026

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

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.