skills.rest
RandallLiuXin
RandallLiuXinCOMMUNITY
Explore all skills by this author →
GitHub

background-map

Generates and validates fixed-viewport background images as loadable Godot Texture2D assets.

531|45|Updated Apr 13, 2026
Search Tags:#image generation#game assets#background#Validation#Godot#parallax#texture2d
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill background-map
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: background-map
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/assets/background-map
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill background-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Producing game backgrounds that actually load in Godot requires coordinating AI image providers, aspect-ratio enforcement, deterministic resizing, and engine-level import checks, which is error-prone when done manually.

Core Features & Use Cases

  • Provider-based image generation: Generates non-pixel-art scenic backgrounds through a declared provider (native, codex, gemini, or openai), with optional style or screen reference images sent as real attachments.
  • Deterministic finalization: Runs the project's asset_image_finalize.py tool to enforce aspect ratio and resize to the target resolution, keeping raw sources and reports as provenance.
  • Five-level validation ladder: Validates family binding, PNG integrity, the single-to-Texture2D route, and real headless Godot loading (L0-L4) before claiming readiness.
  • Use Case: Request a 16:9 parallax plate for a side-scrolling level and receive a validated PNG at assets/generated/background-map/<asset_id>/ that Godot loads directly as a Texture2D.

Quick Start

Ask the agent to generate a 1920x1080 non-pixel-art forest background map asset with asset_type background-map and validate it through the full L0-L4 ladder.

Frequently Asked Questions about background-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a game background image for Godot?▼

Submit an asset request with asset_type background-map, a brief, target aspect and resolution, and a declared provider. The skill generates the image, finalizes it deterministically, and validates it loads in headless Godot as a Texture2D.

Which image providers can generate background assets?▼

The declared provider must be one of native, codex, gemini, or openai, and it is used exactly as declared with no substitution. Codex requests additionally require an auditable provider trace recording model, reasoning, and referenced image paths.

Can I use reference images when generating a background?▼

Yes, references are optional and each declared local path must be a readable image sent to the provider as an actual attachment. A textual path, prompt-only description, or silently omitted reference counts as a failure.

Does the background-map skill support pixel art?▼

No, it produces non-pixel-art scenic images only and forbids nearest-neighbor processing to imitate pixel art. It also excludes actors, props, UI, and collision-bearing geometry from generated backgrounds.

Why does background validation fail after generation?▼

Validation fails when the source aspect does not match before resizing, the PNG is invalid, or headless Godot cannot import and load it as a Texture2D. A failed run returns validation.passed false with no runtime output.

Related Skills

Explore More Design & Creative Skills→
bytedancebytedance
79.6k

image-generation

Generate images from structured JSON prompts and optional reference images.

Official
Intermediate
kodexArgkodexArg

godot-development

Implement Godot 4.x scenes, nodes, and GDScript with lifecycle and input wiring.

Community
Advanced
shirulotshirulot

game-asset-generation

Generate 2D sprites, textures, and UI elements via the each::sense API.

Community
Intermediate
arthur0narthur0n
8

godot-texture-import

Fix Godot PNG texture import and surface-binding settings.

Community
Intermediate