Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot.

MITAuto-check passedGame Development

Install Tileset

skills CLI
$ npx skills add with-pebbly/aseprite-ai-artist --skill tileset -a claude-code

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

GitHub CLI
$ gh skill install with-pebbly/aseprite-ai-artist tileset --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/with-pebbly/aseprite-ai-artist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tileset .claude/skills/tileset && 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
tileset
GitHub stars
172
Token cost
~1.1k tokens
SKILL.md length
625 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot.

  • Works in 5 steps: Draw the tile's interior first, ignoring… → Draw the edge pattern on one side. → look op="ascii" the first and last… → …
  • Terrain and anything that repeats
  • SKILL.md covers Decide the grid before…, Seamless tiles, Autotiling and From a painted mockup, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tileset is an agent skill from with-pebbly/aseprite-ai-artist. Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot. Use for level art, terrain and anything that repeats.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Sprites and pixel art. It works with Godot and Model Context Protocol. The repository describes itself as: Your coding agent paints pixel art in the Aseprite window you already have open. MCP server + skills for Claude Code, omp, Codex, Gemini CLI and Cursor — draws, looks at its…. The licence is MIT.

When your agent uses it

  • Terrain and anything that repeats
  • Tasks that involve Sprites and pixel art

Example prompts

  • “/tileset”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Draw the tile's interior first, ignoring edges.
  2. Draw the edge pattern on one side.
  3. look op="ascii" the first and last columns and make them continue into each
  4. Same for top and bottom rows.
  5. Stamp the tile in a 3×3 block and look op="preview". Seams show up

What it can do on your machine

Read from SKILL.md and the folder at commit f51fe69. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Tileset loads about 1.1k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 625 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from with-pebbly/aseprite-ai-artist at commit f51fe69, republished under its MIT licence (© with-pebbly). 625 words, ~1,107 tokens.

Download SKILL.mdSave it as .claude/skills/tileset/SKILL.md (or your agent's skills folder).
name
tileset
description
Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot. Use for level art, terrain and anything that repeats.
title
Build a tileset

Build a tileset

Requires an extension advertising the tileset feature — check preflight first. Older builds answer unsupported_command loudly rather than doing nothing.

Decide the grid before anything else

The tile size is the one decision everything else depends on, and it belongs to the game, not to the art. Ask if you do not know it. 16×16 and 32×32 are the common answers.

Seamless tiles

A tile is seamless when its right edge continues into its own left edge, and its bottom into its own top.

Method that works:

  1. Draw the tile's interior first, ignoring edges.
  2. Draw the edge pattern on one side.
  3. look op="ascii" the first and last columns and make them continue into each other. This is exact work; do it in the text grid, not by eye.
  4. Same for top and bottom rows.
  5. Stamp the tile in a 3×3 block and look op="preview". Seams show up immediately when tiled; they are invisible in isolation.

Avoid a repeating feature. A distinctive rock in the middle of a grass tile becomes a visible grid the moment it repeats. Keep repeating tiles low-contrast and put the distinctive elements in occasional variant tiles.

Autotiling

A blob-47 set covers every combination of neighbours for a 4-connected terrain. It is 47 tiles, and hand-authoring them in the right order is where this goes wrong — build the terrain body first, then the edge and corner cases, then export with layout="blob47" so the exporter writes the wangset.

From a painted mockup

Painting a level by hand and extracting tiles from it produces better-looking tilesets than authoring tiles in isolation, because you see the whole picture while drawing.

  1. Paint the mockup on a normal layer, on a canvas that is a whole number of tiles in each direction. pack refuses otherwise rather than silently losing a partial edge tile.
  2. Pack it:
    tileset op="pack" layer="mockup" name="terrain" tileWidth=16 tileHeight=16
    You get a tileset plus a tilemap layer that reconstructs the mockup exactly. The mockup is hidden, not deleted — unhide it to compare if a tile looks wrong.
  3. Read the result. cellCount against tileCount tells you how much the mockup actually reused. A 400-cell mockup that yields 300 tiles was painted without regard to the grid; the tool says so, and the fix is to redraw with the grid visible, not to accept it.
  4. tolerance merges near-identical cells (per-channel difference, 0–255). It is off by default because a merge changes the art: the tilemap becomes an approximation of the mockup rather than a copy, and the result says how many cells that affected.
Show full SKILL.md (198 more words)Show less

Export

tileset op="export" layer="terrain" format="tiled" path="…/terrain.tsj"

Writes three files: the packed PNG, the .tsj tileset, and a .tmj map that uses it — so the export opens in Tiled as a level, not just an image.

  • format="godot" writes a Godot 4 TileSet resource (.tres).
  • format="json" writes the tile grid plus the tilemap layout, for a custom engine. It states its own index convention in the file.
  • LDtk needs no exporter — it reads .aseprite directly, so just save the document.

Aseprite reserves tile index 0 for the empty tile. The exporter drops it from the atlas so engine indices line up, and index 0 becomes "no tile", which is what every engine expects.

Autotiling

tileset op="export" format="tiled" layout="blob47" path="…/terrain.tsj"

Adds a Tiled wangset for 4-connected autotiling. It assumes the 47 tiles are authored in canonical blob47 order — the 47 distinct neighbour masks in ascending order, after Aseprite's empty tile — and refuses if the set is incomplete rather than writing a wangset that autotiles wrongly. If you are not sure of the ordering, export format="json" first: it reports the index-to-mask mapping so you can check a few tiles by eye.

rules://04-outlines-and-edges for edge consistency, rules://66-tiles-and-autotiling for layouts and transitions, rules://65-ground-rocks-grass and rules://67-architecture-and-interiors for the tiles themselves, rules://71-isometric for iso sets.

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

Files

Just SKILL.md in skills/tileset of with-pebbly/aseprite-ai-artist.

Open the folder on GitHubat commit f51fe69

Compare with similar skills

Tileset 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.

Tileset compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tileset this skillwith-pebbly/aseprite-ai-artist172—~1.1kAutomated safety check: PassMIT
Game Assetsglifxyz/glif-mcp-server212—~831Automated safety check: PassMIT
Scenario Game Assetsscenario-labs/skills913—~4.5kAutomated safety check: PassMIT
Sprite Genaldegad/sprite-gen2.6k—~4.5kAutomated safety check: PassApache-2.0
2D Sprite Generator0x0funky/agent-sprite-forge4.3k—~3.6kAutomated safety check: PassMIT
AI Game Art Pipelineybuild-ai/ai-game-art-pipeline-skill297—~1.1kAutomated safety check: PassMIT

Similar skills

  • 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…

    212 GitHub stars~831 tokensUpdated today
    Game DevelopmentAuto-check passed
  • Scenario Game Assets

    scenario-labs/skills

    A skill your agent uses when creating game art through Scenario MCP: sprites, sprite sheets, icons, props, loot, tilesets and autotile terrain transitions, seamless tiles, isometric buildings…

    913 GitHub stars~4.5k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Sprite Gen

    aldegad/sprite-gen

    Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation.

    2.6k GitHub stars~4.5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • 2D Sprite Generator

    0x0funky/agent-sprite-forge

    Produces game-ready 2D characters, creatures, props, icons and effects as master stills, sheets or clips, and exports frames for common game engines.

    4.3k GitHub stars~3.6k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • 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
  • MCP Driver

    RandallLiuXin/GodotMaker

    Runtime debugging and live project inspection via godot-mcp.

    549 GitHub starsUsed in 1 repo~1.1k tokens
    Game DevelopmentAuto-check passed

More from with-pebbly/aseprite-ai-artist

All 14 skills in this repo
  • Animate

    with-pebbly/aseprite-ai-artist

    Build an idle, walk, run or attack cycle from key poses, set timing that reads as motion rather than a metronome, tag it, and review it as a filmstrip.

    172 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Draw

    with-pebbly/aseprite-ai-artist

    Draw a sprite from silhouette to finished pixels, in the order that catches mistakes while they are still cheap — block in, check the silhouette, shade, outline, verify.

    172 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Export

    with-pebbly/aseprite-ai-artist

    Produce the files an engine actually consumes — spritesheets with atlases, GIFs, scaled PNGs — with the tags and layout the target needs.

    172 GitHub stars~628 tokensUpdated today
    Auto-check passed
  • Fix

    with-pebbly/aseprite-ai-artist

    Change a sprite that already exists — the user's own work or your earlier output — without destroying what is already right.

    172 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • New

    with-pebbly/aseprite-ai-artist

    Create a new Aseprite document with the right canvas size, colour mode, palette and layer structure, so later work does not have to fight the setup.

    172 GitHub stars~555 tokensUpdated today
    Auto-check passed
  • Palette

    with-pebbly/aseprite-ai-artist

    Pick a palette that fits the request, build hue-shifted ramps, or clean up a sprite whose colours have sprawled.

    172 GitHub stars~795 tokensUpdated today
    Auto-check passed

Questions about Tileset

What does Tileset do?

Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot. Tileset is an agent skill from with-pebbly/aseprite-ai-artist. Design seamless tiles and autotile sets, or deduplicate a hand-painted mockup into a reusable tileset, then export for Tiled or Godot.

When should I use Tileset?

Tileset fits situations like: terrain and anything that repeats; tasks that involve Sprites and pixel art.

How do I install Tileset in Claude Code?

Run `npx skills add with-pebbly/aseprite-ai-artist --skill tileset -a claude-code`. Or copy the skill folder (skills/tileset in with-pebbly/aseprite-ai-artist) into .claude/skills/tileset in your project. Claude Code loads it when a task matches its description.

How do I install Tileset in Codex?

Run `npx skills add with-pebbly/aseprite-ai-artist --skill tileset -a codex`. Or copy the skill folder (skills/tileset in with-pebbly/aseprite-ai-artist) into .agents/skills/tileset in your project. Codex loads it when a task matches its description.

Can I use Tileset 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 with-pebbly/aseprite-ai-artist --skill tileset -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tileset, .gemini/skills/tileset, .github/skills/tileset and .opencode/skills/tileset in your project.

What does Tileset need to run?

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

Does Tileset access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tileset 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. Review the folder before installing.

What licence does Tileset use?

Tileset is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tileset use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tileset?

Skills that share tags, products or a category with Tileset: Game Assets (glifxyz/glif-mcp-server, 212 stars), Scenario Game Assets (scenario-labs/skills, 913 stars), Sprite Gen (aldegad/sprite-gen, 2.6k stars) and 2D Sprite Generator (0x0funky/agent-sprite-forge, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tileset?

with-pebbly (a GitHub organization) maintains it in with-pebbly/aseprite-ai-artist, which has 172 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: with-pebbly/aseprite-ai-artist on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.