# Spritecook Generate Tilesets

> Tileset generation guide for SpriteCook. Use with spritecook-workflow-essentials when generating autotile tilesets through SpriteCook MCP tools, choosing tile sizes, using reference/edit/style asset IDs, and saving generated tileset asset IDs.

- **Type:** Skill
- **Install:** `agentstack add skill-spritecook-skills-spritecook-generate-tilesets`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SpriteCook](https://agentstack.voostack.com/s/spritecook)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SpriteCook](https://github.com/SpriteCook)
- **Source:** https://github.com/SpriteCook/skills/tree/main/skills/spritecook-generate-tilesets

## Install

```sh
agentstack add skill-spritecook-skills-spritecook-generate-tilesets
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://spritecook.ai).

## Tools

### `list_tileset_options`

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 waits up to 90 seconds and returns a job response with generated asset IDs and download URLs when complete.

| 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` or `platformer` |
| `piece_set` | string | registry default | `15-piece`, `17-piece-base`, or `autotile-16-set` |
| `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 `two_surfaces`; `two_surfaces` 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 8 |
| `force_enabled` | bool | `false` | Force the output toward `force_colors` |
| `force_colors` | string[] | null | Optional forced hex palette, max 8 |
| `reference_asset_id` | string | null | Existing tileset asset to use as source/reference; tileset settings are inherited |
| `edit_asset_id` | string | null | Existing tileset asset to edit; tileset settings are inherited |
| `style_asset_id` | string | null | Existing asset to use as visual style guide only |

`reference_asset_id` and `edit_asset_id` are mutually exclusive. The referenced asset must belong to the SpriteCook account.

## Recommended Defaults

- For top-down pixel autotiles, start with `style_mode="pixel"`, `perspective="topdown"`, `piece_set="15-piece"`, `tile_size=32`, `edges="transparent"`.
- For top-down inner-corner base tiles, use `piece_set="17-piece-base"` and keep `edges="transparent"`.
- For side-view platformers, use `perspective="platformer"`, `piece_set="autotile-16-set"`, `edges="transparent"`.
- For detailed top-down tilesets, use `style_mode="detailed"` and call `list_tileset_options` before choosing size/elevation.
- Use `model` only when the user explicitly wants to compare models.

## Reference Workflow

- When the user asks to use a saved tileset preset, use `list_presets(mode="tileset", query=...)` and `get_preset_settings` first, then map the returned tileset settings into `generate_tileset`.
- If the user has a local image file path, use `spritecook-upload-assets` first, then pass the returned asset ID as `reference_asset_id`, `edit_asset_id`, or `style_asset_id`.
- If the user supplies a small data URL or raw base64 value, call `import_asset` first, then pass the returned asset ID as `reference_asset_id`, `edit_asset_id`, or `style_asset_id`.
- Use `reference_asset_id` when the existing tileset should guide a new generation while preserving its tile size/layout.
- Use `edit_asset_id` when the user wants a direct change to an existing tileset.
- Use `style_asset_id` as 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 `style_mode`, `perspective`, `piece_set`, `tile_size`, or `elevation`; 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

- Save the returned `asset_id` in the project manifest or task notes.
- Use the returned `pixel_url` for pixel-art tilesets when available.
- Use the returned `raw_url` when the user asks for the original generated asset variant.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SpriteCook](https://github.com/SpriteCook)
- **Source:** [SpriteCook/skills](https://github.com/SpriteCook/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-spritecook-skills-spritecook-generate-tilesets
- Seller: https://agentstack.voostack.com/s/spritecook
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.