Tilemap Data Format

Use when designing the map data format (layers, tiles, objects, metadata) so maps are editable, versionable, and engine-agnostic.

49 stars 6 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add 0xheycat/isometric-game-skills --skill tilemap-data-format
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/tilemap-data-format ~/.claude/skills/tilemap-data-format

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Tilemap Data Format

## Overview

A good map format separates data from rendering. This skill defines a JSON tilemap with layers (ground, transitions, objects) and per-tile metadata (walkable, type) so designers and the engine share one source of truth.

## When to Use

- You are deciding how maps are stored.
- Maps are hard-coded in source instead of data files.
- You need walkability/metadata alongside visuals.

## Process

1. Separate layers: ground, transitions, objects, and a collision/walkable layer.
2. Store the grid as width/height + arrays of tile indices per layer.
3. Reference tiles by atlas name or index, never by raw pixel coords.
4. Attach per-tile metadata (type, walkable, cost) for gameplay systems.
5. Keep it pure JSON so it diffs cleanly in git and loads anywhere.
6. Version the format with a `version` field for migrations.
7. Validate maps on load (dimensions, indices in range).

```json
{ "version": 1, "w": 32, "h": 32,
  "layers": { "ground": [/*...*/], "objects": [/*...*/] },
  "meta": { "walkable": [/*...*/] } }
```

## Rationalizations (Stop Lying to Yourself)

| Excuse | Reality |
|---|---|
| "I will hard-code the map in code" | Then designers cannot touch it and diffs are unreadable. Use data files. |
| "One flat array is enough" | Gameplay needs a separate walkable layer. Separate concerns. |

## Red Flags - STOP if you catch yourself:

- Maps embedded in source instead of data files.
- No walkable/collision layer.
Read the full skill on GitHub

Details

Skill name
tilemap-data-format
Path
skills/tilemap-data-format/SKILL.md
License
MIT
Repo updated
12 August 2026

FAQ

What does the Tilemap Data Format skill do?

Use when designing the map data format (layers, tiles, objects, metadata) so maps are editable, versionable, and engine-agnostic.

How do I install the Tilemap Data Format skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add 0xheycat/isometric-game-skills --skill tilemap-data-format. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Tilemap Data Format 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.