Tilemap Data Format
Use when designing the map data format (layers, tiles, objects, metadata) so maps are editable, versionable, and engine-agnostic.
Install
npx skills add 0xheycat/isometric-game-skills --skill tilemap-data-formatgit 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-formatPersonal 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.Details
- Skill name
tilemap-data-format- Repository
- 0xheycat/isometric-game-skills
- Path
skills/tilemap-data-format/SKILL.md- License
- MIT
- Repo updated
- 12 August 2026
- Listed in
- heilcheng/awesome-agent-skills
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
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.
Tlaplus Add Variable
49tlaplus/AgentSkills
Add a new variable to an existing TLA+ specification without changing its semantics. Ensures the variable is declared, initialized, and added to all UNCHANGED statements. Use when the user asks to add, introduce, or declare a new variable in a TLA+ spec, or mentions UNCHANGED statements.
Tile Picking Interaction
490xheycat/isometric-game-skills
Use when converting a mouse/touch position into the correct isometric tile for selection, highlighting, and placement.
Transparent Cutout Cleanup
490xheycat/isometric-game-skills
Use when removing backgrounds from generated sprites to get clean alpha edges with no halo, fringe, or leftover background pixels.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.