SpriteCook Use Presets
Use this skill with spritecook-workflow-essentials and the relevant generation skill.
Presets are saved SpriteCook settings and prompt recipes. Their purpose is to help the user get consistent, similar output later, especially when they need a collection of related assets with the same style, model, prompt structure, dimensions, color guidance, and reference images. Users can fine-tune and save presets in the SpriteCook app, then ask an agent to use those presets through MCP.
When To Use Presets
- Use presets when the user explicitly says
use my preset, names a saved preset, or asks for assets matching a saved SpriteCook setup.
- Use presets when the user implies continuity with a named saved style or workflow, such as
use my character preset for this.
- Do not browse presets by default for ordinary generation requests. If the user does not mention or imply a preset, use the normal SpriteCook generation workflow.
- Use
save_private_preset only when the user asks to save a preset or preserve these settings for future use.
Fetch And Apply
- Call
list_presets(query=...) with the user's preset name or intent.
- Pick the best match by title first, then mode, status, description, and settings.
- If multiple plausible presets remain, ask a concise clarification before generating.
- Call
get_preset_settings(preset_id=...) for the selected preset.
- Map returned settings into the relevant MCP tool:
prompt -> base prompt or prompt guidance.
themeText -> theme.
styleText -> style.
width, height, pixel, bgMode, aspectRatio, smartCropEnabled, smartCropMode, detailedModel, resolution, quality, and colors -> matching generation arguments when the target tool supports them.
settings.reference.styleAssetIds -> style_asset_ids for generate_game_art, up to 10 asset IDs.
settings.reference.contextAssetId -> reference_asset_id for generate_game_art.
settings.reference.editAssetId -> edit_asset_id for generate_game_art only when the user is modifying that specific image.
tilesetPerspective, tilesetPieceSet, and tilesetElevation -> generate_tileset settings.
- Preserve the user's requested subject or change. The preset should guide style/settings; it should not override the user's new intent unless the user asks for an exact repeat.
Reference Images
- Private draft presets can return owned asset IDs:
settings.reference.styleAssetIds
settings.reference.contextAssetId
settings.reference.editAssetId
- Published presets can return frozen preset media URLs:
settings.reference.styleUploadUrls
settings.reference.contextUploadUrl
settings.reference.editUploadUrl
- Use
style_asset_ids directly for settings.reference.styleAssetIds when calling generate_game_art; pass at most 10 IDs.
- Use
reference_asset_id for settings.reference.contextAssetId when the preset provides one specific visual/context reference.
- Use
edit_asset_id only for settings.reference.editAssetId, when the user is modifying that specific image.
- Treat style asset IDs as ambient style guide images: they establish style, palette, proportions, and rendering for new related assets. The prompt does not need to restate that they are style references unless the user asks to emphasize a specific detail.
- If a preset returns multiple style asset IDs but the target tool only accepts one, prefer the first style asset unless the user asks to choose differently.
- If a preset returns upload URLs that the target MCP generation tool cannot consume, still use the text/model/size/color settings and mention that the media reference could not be applied through that tool.
Saving Presets
- Use
save_private_preset(...) only after the user asks to save a preset.
- Save presets as private drafts only. Do not publish, share, or submit anything for moderation.
- Include the settings that matter for repeatability: prompt pattern, theme, style, model, size, pixel mode, background mode, smart crop, quality, colors, and supported reference/edit/style images.
- Use
style_references, reference_image, edit_image, and preview asset IDs when the user wants the saved preset to include those images.
- If saving fails because of the private preset limit or unavailable reference assets, explain the user-facing problem briefly and do not retry with missing references unless the user asks.
Practical Pattern
When the user says Use my character preset for a blue wizard idle sprite:
list_presets(query="character")
- Select the likely character preset.
get_preset_settings(preset_id="...")
- Generate with the preset's style/settings plus the new subject:
blue wizard idle sprite.
1---2name: spritecook-use-presets3description: "Use SpriteCook saved presets through MCP. Use when the user explicitly asks to use a preset, refers to one of their saved SpriteCook presets, asks for the same style/settings as a saved preset, or asks to save a private preset for future consistent asset generation."4metadata:5 source: https://skillmd.com/skills/spritecook/spritecook-use-presets6---78# SpriteCook Use Presets910Use this skill with `spritecook-workflow-essentials` and the relevant generation skill.1112Presets are saved SpriteCook settings and prompt recipes. Their purpose is to help the user get consistent, similar output later, especially when they need a collection of related assets with the same style, model, prompt structure, dimensions, color guidance, and reference images. Users can fine-tune and save presets in the SpriteCook app, then ask an agent to use those presets through MCP.1314## When To Use Presets1516- Use presets when the user explicitly says `use my preset`, names a saved preset, or asks for assets matching a saved SpriteCook setup.17- Use presets when the user implies continuity with a named saved style or workflow, such as `use my character preset for this`.18- Do not browse presets by default for ordinary generation requests. If the user does not mention or imply a preset, use the normal SpriteCook generation workflow.19- Use `save_private_preset` only when the user asks to save a preset or preserve these settings for future use.2021## Fetch And Apply22231. Call `list_presets(query=...)` with the user's preset name or intent.242. Pick the best match by title first, then mode, status, description, and settings.253. If multiple plausible presets remain, ask a concise clarification before generating.264. Call `get_preset_settings(preset_id=...)` for the selected preset.275. Map returned settings into the relevant MCP tool:28 - `prompt` -> base prompt or prompt guidance.29 - `themeText` -> `theme`.30 - `styleText` -> `style`.31 - `width`, `height`, `pixel`, `bgMode`, `aspectRatio`, `smartCropEnabled`, `smartCropMode`, `detailedModel`, `resolution`, `quality`, and `colors` -> matching generation arguments when the target tool supports them.32 - `settings.reference.styleAssetIds` -> `style_asset_ids` for `generate_game_art`, up to 10 asset IDs.33 - `settings.reference.contextAssetId` -> `reference_asset_id` for `generate_game_art`.34 - `settings.reference.editAssetId` -> `edit_asset_id` for `generate_game_art` only when the user is modifying that specific image.35 - `tilesetPerspective`, `tilesetPieceSet`, and `tilesetElevation` -> `generate_tileset` settings.366. Preserve the user's requested subject or change. The preset should guide style/settings; it should not override the user's new intent unless the user asks for an exact repeat.3738## Reference Images3940- Private draft presets can return owned asset IDs:41 - `settings.reference.styleAssetIds`42 - `settings.reference.contextAssetId`43 - `settings.reference.editAssetId`44- Published presets can return frozen preset media URLs:45 - `settings.reference.styleUploadUrls`46 - `settings.reference.contextUploadUrl`47 - `settings.reference.editUploadUrl`48- Use `style_asset_ids` directly for `settings.reference.styleAssetIds` when calling `generate_game_art`; pass at most 10 IDs.49- Use `reference_asset_id` for `settings.reference.contextAssetId` when the preset provides one specific visual/context reference.50- Use `edit_asset_id` only for `settings.reference.editAssetId`, when the user is modifying that specific image.51- Treat style asset IDs as ambient style guide images: they establish style, palette, proportions, and rendering for new related assets. The prompt does not need to restate that they are style references unless the user asks to emphasize a specific detail.52- If a preset returns multiple style asset IDs but the target tool only accepts one, prefer the first style asset unless the user asks to choose differently.53- If a preset returns upload URLs that the target MCP generation tool cannot consume, still use the text/model/size/color settings and mention that the media reference could not be applied through that tool.5455## Saving Presets5657- Use `save_private_preset(...)` only after the user asks to save a preset.58- Save presets as private drafts only. Do not publish, share, or submit anything for moderation.59- Include the settings that matter for repeatability: prompt pattern, theme, style, model, size, pixel mode, background mode, smart crop, quality, colors, and supported reference/edit/style images.60- Use `style_references`, `reference_image`, `edit_image`, and preview asset IDs when the user wants the saved preset to include those images.61- If saving fails because of the private preset limit or unavailable reference assets, explain the user-facing problem briefly and do not retry with missing references unless the user asks.6263## Practical Pattern6465When the user says `Use my character preset for a blue wizard idle sprite`:66671. `list_presets(query="character")`682. Select the likely character preset.693. `get_preset_settings(preset_id="...")`704. Generate with the preset's style/settings plus the new subject: `blue wizard idle sprite`.