# Tinyworld Auto Batching

> Tinyworld Auto Batching is an Agent Skill for development published in the jasonkneen/tiny-world-builder repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when changing Tiny World Builder Auto palette behavior, model inference, suggestions, or provider/model/API-key logic.

- Skill name: `tinyworld-auto-batching`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/jasonkneen/tiny-world-builder/blob/HEAD/.codex/skills/tinyworld-auto-batching/SKILL.md
- Repository: jasonkneen/tiny-world-builder (1,444 GitHub stars when collected)

## SKILL.md

# Tiny World Auto Batching

Auto should not call the model on every placement.

Current intended model:

- Capture the current home board as sparse 8x8 JSON using `snapshotCells()`.
- Ask the model for a ranked batch of candidate tile actions matching `AUTO_SUGGESTIONS_SCHEMA`.
- Spend `autoSuggestionQueue` locally for multiple Auto placements.
- Refresh after `AUTO_REFRESH_EVERY` Auto placements or when the queue runs out.
- Auto still places on the clicked cell. The model suggests tile/action definitions, not coordinates.

Implementation guardrails:

- Keep provider/model/key state shared with the Generate modal via `AI_LS`.
- Use `normalizeAutoAction` before applying model output.
- Use `adaptAutoSuggestionToCell(action, x, z)` so same-kind clicks increase local intensity.
- If no API key exists, open the Generate modal with the Auto key message.
- Do not add a backend or new dependency.

Validation:

- Stub `generateAutoSuggestions` in browser eval and verify two Auto suggestions only call the stub once.
- Verify no network call is needed while spending cached suggestions.

---

Source: https://www.openparable.com/skill/development/tinyworld-auto-batching (OpenParable). Cite the canonical URL above.
