Agent skill

Godot Tilemap Mastery

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design.

LGPL-3.0Auto-check passedGame Development

Install Godot Tilemap Mastery

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-tilemap-mastery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-tilemap-mastery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedivergentai/GD-Agentic-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/godot-tilemap-mastery .claude/skills/godot-tilemap-mastery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
godot-tilemap-mastery
GitHub stars
821
Token cost
~2.9k tokens
SKILL.md length
764 words
Files
18 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design.

  • Building grid-based levels OR implementing destructible tiles
  • SKILL.md covers NEVER Do in TileMaps, Decision Tree: How to Write…, Available Scripts (single… and Expert Trade-offs (routing only), plus 2 more sections
  • Tasks that involve Sprites and pixel art
  • Tasks that involve Game development

What it does

Godot Tilemap Mastery is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design. Covers terrain autotiling, physics layers, custom data, navigation integration, and runtime manipulation. Use when building grid-based levels OR implementing destructible tiles. Keywords TileMapLayer, TileSet, terrain, autotiling, atlas, physics layer, custom data.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts and reference files (for example `references/expert-tilemap-architectures.md`, `references/migration-notes.md` and `references/runtime-tile-patterns.md`).

It sits in Game Development, covering Sprites and pixel art and Game development. It works with Godot. The repository describes itself as: The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns… The licence is LGPL-3.0.

When your agent uses it

  • Building grid-based levels OR implementing destructible tiles
  • Tasks that involve Sprites and pixel art
  • Tasks that involve Game development

Example prompts

  • “/godot-tilemap-mastery”

What it can do on your machine

Read from SKILL.md and the folder at commit 4c4d0ff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 13 files in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.godotengine.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Godot Tilemap Mastery loads about 2.9k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 93 tokens; SKILL.md has 764 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thedivergentai/GD-Agentic-Skills at commit 4c4d0ff, republished under its LGPL-3.0 licence (© thedivergentai). 764 words, ~2,876 tokens.

Download SKILL.mdSave it as .claude/skills/godot-tilemap-mastery/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
godot-tilemap-mastery
description
Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design. Covers terrain autotiling, physics layers, custom data, navigation integration, and runtime manipulation. Use when building grid-based levels OR implementing destructible tiles. Keywords TileMapLayer, TileSet, terrain, autotiling, atlas, physics layer, custom data.

NEVER Do in TileMaps

  • NEVER call set_cell() in huge loops without batching — Prefer terrain connect, patterns, or chunk batchers.
  • NEVER forget source_id in set_cell — Wrong overload → crash or silent miss.
  • NEVER mix world coords with tile coords — Always local_to_map / map_to_local.
  • NEVER hand-paint organic blobs when terrains exist — Use terrain sets + set_cells_terrain_connect.
  • NEVER put dynamic actors in the TileMap — Enemies/pickups are nodes; tiles are geometry / destructible cells.
  • NEVER spam get_cell_tile_data() every physics frame — Cache metadata (fast_metadata_cache.gd).

Decision Tree: How to Write Cells

GoalPreferScriptTrade-off
Organic ground / roads / riversTerrain autotileterrain_autotile.gd / terrain_path_painter.gdSetup cost in TileSet; fastest designer iteration
Prefab rooms / houses / stampsTileMapPatterntile_pattern_stamper.gdGreat for procgen pieces; less flexible per-cell
Sparse / precise editsset_cell—Fine for few cells; bad for thousands/frame
Huge streaming worldsChunkstilemap_chunking.gd / procedural_chunk_batcher.gd / tilemap_data_manager.gdIndirection + load boundaries
Destructible dig/breakCustom data HPdestructible_tile_logic.gdMust refresh nav/physics after edits
Gameplay queries (friction/hazard)Custom data + cachegameplay_data_query.gd / fast_metadata_cache.gdCache invalidation on set_cell
Nav after editsRuntime nav fixnav_mesh_teleport_fix.gdCostly if every cell; batch rebuilds
One-way / physics layersTileSet physicsphysics_shape_interaction.gdAlign with CharacterBody masks
Iso / multi-floor sortY-sort layerssorting_Z_layering.gdParent + all layers need y_sort
Legacy TileMap → layersMigrationtilemap_layer_v43_upgrade.gdOne-time upgrade aid

Editor atlas/physics paint setup: Official Documentation in Reference — Do NOT reload Steps 1–3 / flood_fill tutorials from this skill body.

Available Scripts (single index + MANDATORY triggers)

TaskMANDATORY script(s)
Serialize / large world datatilemap_data_manager.gd
Runtime terrain pathsterrain_path_painter.gd / terrain_autotile.gd
Destructible tilesdestructible_tile_logic.gd
Custom data gameplay readsgameplay_data_query.gd (+ fast_metadata_cache.gd if hot)
Procedural bulk placeprocedural_chunk_batcher.gd
Chunk stream in/outtilemap_chunking.gd
Pattern stamp prefabstile_pattern_stamper.gd
Nav repair after editsnav_mesh_teleport_fix.gd
One-way / physics layer opsphysics_shape_interaction.gd
Y-sort / Z layeringsorting_Z_layering.gd
4.3+ multi-layer upgradetilemap_layer_v43_upgrade.gd

Expert Trade-offs (routing only)

Deep recipes (on demand)

LLM-ignorance rule: if a general agent would not know it before reading, it lives here or in scripts/ — never delete, only move.

TopicReference
TileSet editor stepstileset-editor-setup.md
Runtime APIs + flood/terrainruntime-tile-patterns.md
Iso / patterns / diffexpert-tilemap-architectures.md

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing to a peer domain — do not preload the whole lattice.

Show full SKILL.md (368 more words)Show less
Official Documentation
  • Using TileMaps — TileMapLayer workflow, layers, runtime set_cell / terrain painting, and when multiple layers beat a single legacy TileMap.
  • Using TileSets — atlas sources, terrains, physics/navigation/custom data layers painted in the TileSet editor.
  • TileMapLayer — cell APIs, terrain connect, patterns, coordinate conversion, and runtime tile-data updates.
  • TileSet — physics/terrain/custom-data layer definitions shared by every TileMapLayer that references the resource.
  • TileSetAtlasSource — atlas grid, alternatives, and per-tile TileData that drive collision and metadata.
  • TileData — custom data, physics polygons, navigation polygons, and y_sort_origin used at query time.
  • TileMapPattern — capture/stamp multi-tile prefabs without per-cell set_cell loops.
  • Collision shapes (2D) — shape choices and one-way collision patterns that TileSet physics layers expose to CharacterBody2D.
  • Navigation introduction (2D) — how tile navigation polygons feed NavigationRegion2D / NavigationAgent2D after edits.
  • Canvas layers — z-index / CanvasLayer separation for ground, decoration, and roof TileMapLayers.
  • Background loading — threaded ResourceLoader patterns for streaming chunk TileSets / tilemap scenes without hitch spikes.
Prerequisites
  • godot-project-foundations — scene tree, resources, and import layout before authoring TileSet atlases and multi-layer level scenes.
  • godot-gdscript-mastery — typed Vector2i APIs, caching patterns, and signal-up/call-down structure used in runtime tile managers.
  • godot-2d-physics — collision layers/masks and StaticBody2D-equivalent behavior that TileMapLayer physics layers participate in.
Complements
  • godot-version-migration — tilemap_layer_v43_upgrade and TileMap→TileMapLayer sit on the 4.x hop path; run engine upgrades via the migration hub before applying layer scripts.
  • godot-characterbody-2d — move_and_slide against tile colliders, one-way platforms, and floor/wall queries over TileMapLayer geometry.
  • godot-navigation-pathfinding — NavigationAgent2D / region updates when destructible or procedural tiles change walkable polygons.
  • godot-camera-systems — Camera2D limits and follow radii that drive chunk load/unload around the player.
  • godot-adapt-3d-to-2d — isometric / Y-sort depth tricks that pair with TILE_SHAPE_ISOMETRIC and multi-floor TileMapLayers.
  • godot-scene-management — packing and swapping chunk scenes so large tile worlds stream without orphaned layers.
  • godot-performance-optimization — batching, cache budgets, and profiler checks when set_cell / custom-data queries dominate frame time.
Downstream / consumers
  • godot-procedural-generation — noise/BSP/WFC generators that write cells via terrain connect, patterns, or chunk batchers.
  • godot-genre-platformer — precision platformer levels built from TileSet physics, one-ways, and hazard custom data.
  • godot-genre-metroidvania — interconnected room grids, ability gates, and map revelation layered on TileMapLayer chunks.
  • godot-genre-sandbox — diggable/buildable 2D worlds that treat TileMapLayer as the editable terrain backend.
  • godot-monte-carlo-balancer — simulate hazard density, destructible HP, and traversal cost encoded in tile custom data before shipping maps.
Master
  • godot-master — library router and mirrored module entry for cross-skill discovery.

© thedivergentai, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (scripts, references) in skills/godot-tilemap-mastery of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/expert-tilemap-architectures.md
  • references/migration-notes.md
  • references/runtime-tile-patterns.md
  • references/tileset-editor-setup.md
  • scripts/destructible_tile_logic.gd
  • scripts/fast_metadata_cache.gd
  • scripts/gameplay_data_query.gd
  • scripts/nav_mesh_teleport_fix.gd
  • scripts/physics_shape_interaction.gd
  • scripts/procedural_chunk_batcher.gd
  • scripts/sorting_Z_layering.gd
  • scripts/terrain_autotile.gd
  • scripts/terrain_path_painter.gd
  • scripts/tile_pattern_stamper.gd
  • scripts/tilemap_chunking.gd
  • scripts/tilemap_data_manager.gd
  • scripts/tilemap_layer_v43_upgrade.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Tilemap Mastery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Godot Tilemap Mastery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Tilemap Mastery this skillthedivergentai/GD-Agentic-Skills821—~2.9kAutomated safety check: PassLGPL-3.0
AI Game Art Pipelineybuild-ai/ai-game-art-pipeline-skill297—~1.1kAutomated safety check: PassMIT
Godot 2D Essentialsjame581/GodotPrompter805—~2.3kAutomated safety check: PassMIT
GecsRandallLiuXin/GodotMaker550—~2.7kAutomated safety check: PassCustom licence
Godot Asset Generatorjwynia/agent-skills170—~3.8kAutomated safety check: PassMIT
Godot Animation Systemjame581/GodotPrompter805—~3.8kAutomated safety check: PassMIT

Similar skills

  • AI Game Art Pipeline

    ybuild-ai/ai-game-art-pipeline-skill

    Provider-neutral open-source skill for planning and producing game-runtime art assets and animation: static props/icons, canonical character sheets, combat sprites, 3D/video motion references…

    297 GitHub stars~1.1k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • Godot 2D Essentials

    jame581/GodotPrompter

    Covers Godot 4.3+ 2D systems with GDScript and C# examples: canvas layers, draw order, TileMaps, parallax, lights and shadows, particles and custom drawing.

    805 GitHub stars~2.3k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Gecs

    RandallLiuXin/GodotMaker

    gecs ECS framework API reference — the Entity-Component-System addon for Godot 4.x used by this project.

    550 GitHub stars~2.7k tokensUpdated 23 days ago
    Game DevelopmentAuto-check passed
  • Godot Asset Generator

    jwynia/agent-skills

    Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.

    170 GitHub stars~3.8k tokensUpdated 7 mo ago
    Game DevelopmentAuto-check passed
  • Godot Animation System

    jame581/GodotPrompter

    Covers animation in Godot 4.3 and later: AnimationPlayer basics, AnimationTree blend trees and state machines, sprite animation, skeleton IK and code-driven motion.

    805 GitHub stars~3.8k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Game Assets

    glifxyz/glif-mcp-server

    Make art and media for a game you are building with Glif: character reference sheets, consistent characters, pixel-art sprite sheets with animation cycles, seamless and PBR textures, 3D models, item…

    213 GitHub stars~831 tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed

More from thedivergentai/GD-Agentic-Skills

All 98 skills in this repo
  • Godot 2D Animation

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 2D animation in Godot using AnimatedSprite2D and skeletal cutout rigs.

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot 3D World Building

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 3D level design using GridMap with MeshLibrary, CSG constructive solid geometry, occlusion, and runtime GridMap builders.

    821 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 2D To 3D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for migrating 2D games to 3D including node type conversions, camera systems (third-person, first-person, orbit), physics layer migration, sprite-to-model art pipeline, and control…

    821 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 3D To 2D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for simplifying 3D games to 2D including dimension reduction strategies, 2.5D fake-depth, isometric ports, camera flattening, physics conversion, 3D-to-sprite art pipeline, and…

    821 GitHub stars~4.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Agent Vision

    thedivergentai/GD-Agentic-Skills

    Agentic eyes for Godot work: cross-platform screenshot CLI (asset/region/window/screen) to budgeted WebP, TEMP editor viewport bridge under .gdskills/, and Taste Receptor Atlas v2 (~237…

    821 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Animation Tree Mastery

    thedivergentai/GD-Agentic-Skills

    Expert patterns for AnimationTree including StateMachine transitions, BlendSpace2D for directional movement, BlendTree for layered animations, root motion, transition conditions, advance…

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Godot Tilemap Mastery

What does Godot Tilemap Mastery do?

Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design. Godot Tilemap Mastery is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for TileMapLayer and TileSet systems for efficient 2D level design.

When should I use Godot Tilemap Mastery?

Godot Tilemap Mastery fits situations like: building grid-based levels OR implementing destructible tiles; tasks that involve Sprites and pixel art; tasks that involve Game development.

How do I install Godot Tilemap Mastery in Claude Code?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-tilemap-mastery -a claude-code`. Or copy the skill folder (skills/godot-tilemap-mastery in thedivergentai/GD-Agentic-Skills) into .claude/skills/godot-tilemap-mastery in your project. Claude Code loads it when a task matches its description.

How do I install Godot Tilemap Mastery in Codex?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-tilemap-mastery -a codex`. Or copy the skill folder (skills/godot-tilemap-mastery in thedivergentai/GD-Agentic-Skills) into .agents/skills/godot-tilemap-mastery in your project. Codex loads it when a task matches its description.

Can I use Godot Tilemap Mastery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-tilemap-mastery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godot-tilemap-mastery, .gemini/skills/godot-tilemap-mastery, .github/skills/godot-tilemap-mastery and .opencode/skills/godot-tilemap-mastery in your project.

What does Godot Tilemap Mastery need to run?

SKILL.md names no scripts, command-line tools or credentials: Godot Tilemap Mastery is instructions for the agent only.

Does Godot Tilemap Mastery access the network?

SKILL.md names 1 domain. As links in the text: docs.godotengine.org. This is read from the text; nothing was executed.

Is Godot Tilemap Mastery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Godot Tilemap Mastery use?

Godot Tilemap Mastery is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godot Tilemap Mastery use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Godot Tilemap Mastery?

Skills that share tags, products or a category with Godot Tilemap Mastery: AI Game Art Pipeline (ybuild-ai/ai-game-art-pipeline-skill, 297 stars), Godot 2D Essentials (jame581/GodotPrompter, 805 stars), Gecs (RandallLiuXin/GodotMaker, 550 stars) and Godot Asset Generator (jwynia/agent-skills, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Tilemap Mastery?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 821 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 9, 2026.

Source: thedivergentai/GD-Agentic-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.