SKILL.md
SpriteCook Generate Tilesets
Use this skill for SpriteCook tileset generation. Pair it with spritecook-workflow-essentials for credits, manifests, safe downloads, and asset tracking.
Requires: SpriteCook MCP server connected to your editor. Set up with npx spritecook-mcp setup or see spritecook.ai.
Tools
listtilesetoptions
Call this when you need current supported perspectives, piece sets, tile sizes, elevations, edge modes, output dimensions, or defaults.
generate_tileset
Generate a game-ready tileset. The tool returns a job immediately by default; follow the returned poll.tool and poll.arguments until canonical assets entries are ready.
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt |
string | required | Terrain/material request, e.g. mossy dungeon floor |
style_mode |
string | pixel |
pixel or detailed |
perspective |
string | topdown |
topdown, platformer, or isometric |
piece_set |
string | registry default | 15-piece, 17-piece-base, autotile-16-set, isometric-3x5-32, or isometric-2x4-64 |
tile_size |
int | registry default | Final tile size in pixels |
elevation |
string | registry default | no-elevation or minimal where supported |
edges |
string | transparent |
transparent or twosurfaces; twosurfaces only works for 15-piece top-down |
variations |
int | 1 |
Number of variations, 1-4 |
model |
string | null | Optional model override. Omit to use SpriteCook's tileset default |
colors |
string[] | null | Optional hex color guidance, max 64 |
force_enabled |
bool | false |
Force the output toward force_colors |
force_colors |
string[] | null | Optional forced hex palette, max 64 |
referenceassetid |
string | null | Existing tileset asset to use as source/reference; tileset settings are inherited |
editassetid |
string | null | Existing tileset asset to edit; tileset settings are inherited |
styleassetid |
string | null | Existing asset to use as visual style guide only |
wait_seconds |
int | 0 | Optional bounded wait from 0-90 seconds before returning the polling contract |
referenceassetid and editassetid are mutually exclusive. The referenced asset must belong to the SpriteCook account.
Recommended Defaults
- For top-down pixel autotiles, start with
stylemode="pixel",perspective="topdown",pieceset="15-piece",tile_size=32,edges="transparent". - For top-down inner-corner base tiles, use
piece_set="17-piece-base"and keepedges="transparent". - For side-view platformers, use
perspective="platformer",piece_set="autotile-16-set",edges="transparent". - For detailed top-down tilesets, use
stylemode="detailed"and calllisttileset_optionsbefore choosing size/elevation. - Use
modelonly when the user explicitly wants to compare models.
Reference Workflow
- When the user asks to use a saved tileset preset, use
listpresets(mode="tileset", query=...)andgetpresetsettingsfirst, then map the returned tileset settings intogeneratetileset. - If the user has a local image file path, use
spritecook-upload-assetsfirst, then pass the returned asset ID asreferenceassetid,editassetid, orstyleassetid. - If the user supplies a small data URL or raw base64 value, call
importassetfirst, then pass the returned asset ID asreferenceassetid,editassetid, orstyleasset_id. - Use
referenceassetidwhen the existing tileset should guide a new generation while preserving its tile size/layout. - Use
editassetidwhen the user wants a direct change to an existing tileset. - Use
styleassetidas a style guide image when the image should affect only visual style, palette, proportions, and rendering, not tileset layout. The prompt does not need to repeat that the image is a style guide unless the user asks to emphasize a specific detail. - When referencing or editing a tileset, do not change
stylemode,perspective,pieceset,tile_size, orelevation; SpriteCook inherits and locks those settings.
Prompting
- Keep prompts short and material-focused:
snowy stone path,muddy swamp grass,volcanic rock,clean wooden floor. - For single-surface tilesets, name one main material.
- For
two_surfaces, name both surfaces clearly:grass and water,volcanic rock and lava. - Avoid asking for labels, UI, characters, props, or scene composition inside the tileset.
Output Handling
- Follow the returned polling contract with
checkjobstatusuntil the job reaches a terminal state. - Save each returned
asset_idin the project manifest or task notes. - Use
sprite_urlas the canonical downloadable tileset image. - Treat
url,pixelurl, andrawurlas compatibility aliases. - If a successful response contains
warning.code="assetoutputunavailable", execute the suppliedwarning.recoverytool call.