kayforkind/skill-slice/assets-pipeline

Claude Code and agent skill by kayforkind/skill-slice

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Configures Godot 4.x import-time assets: texture compression, glTF/.blend scenes, WAV/Ogg, .tres/.res, and .import sidecars plus headless reimport. Use when importing textures, glTF, blend, wav/ogg, tres/res, or running godot --headless --import. Not for runtime audio buses (audio-system), 3D materials/lighting (3d-essentials), 2D sprites (2d-essentials), animation playback, or WASM/web export.

Install

npx vskill@latest install kayforkind/skill-slice/assets-pipeline

SKILL.md

The same SKILL.md was published earlier as kayforkind/skill-slice/assets-pipeline.

When to Use

Use this skill when working with asset import and management in Godot 4.x, including:

  • Image / texture import — choosing between lossless and VRAM-compressed modes, filtering, and mipmaps. The right choice depends on whether the texture is 2D UI/pixel art (where sharpness matters) or a 3D surface (where GPU memory and sampling cost matter).
  • 3D scene import — bringing in glTF 2.0 (.glb / .gltf) or .blend files and configuring scale, generated collision shapes, and LODs. Import-time decisions here are hard to change later because they bake into the cached scene.
  • Audio import — selecting a format per use case (short SFX vs. music) and setting loop points / normalization, which the engine cannot infer on its own.
  • Resource format selection — deciding between .tres (text) and .res (binary) based on whether you value version-control diffs or load speed/size.
  • Import pipeline configuration — understanding sidecar .import files, the regenerated .godot/imported/ cache, and how to reimport reliably (including in CI).

Do Not Use

These topics live in other skills because they concern runtime behavior, not import-time configuration:

  • For audio playback logic and bus routing → use the audio-system skill.
  • For 3D material and lighting setup → use the 3d-essentials skill.
  • For 2D rendering and sprite composition → use the 2d-essentials skill.
  • For animation playback wiring → use the animation-system skill.
  • For assets that need WASM / web export tuning → use the web-export skill.
  • For AI-generated assets, verify copyright/licensing before integrating; this skill assumes you already have the right to ship the asset.

Prerequisites

  • Godot 4.x editor installed and on PATH (or invoke the binary directly).
  • A Godot project with a project.godot file at the root.
  • Git initialized in the project root (for .gitignore and VCS checks).
  • Windows host is primary (PowerShell). Commands below use PowerShell syntax; adapt for bash on other platforms.

Procedure

1. Understand the three-part import system

When you drop a file into res://, Godot auto-imports it into an engine-optimized form. Understanding where each piece lives explains the version-control rules:

project/
├── textures/
│ ├── player.png ← original source file (commit this)
│ └── player.png.import ← import settings sidecar (commit this)
└── .godot/
└── imported/ ← compiled, machine-specific cache (do NOT commit)
  • The original is your source of truth.
  • The `.import` sidecar records how to transform the original (compression mode, filter, etc.). It is small, text-based, and belongs in version control so every teammate and CI machine reproduces the same import.
  • The `.godot/imported/` cache is regenerated from the first two. It is large and machine-specific, so committing it only causes merge conflicts and bloat.
2. Configure .gitignore (Windows PowerShell)
powershell
# From the project root:
if (-not (Test-Path .gitignore)) { New-Item -ItemType File .gitignore }
$lines = Get-Content .gitignore -ErrorAction SilentlyContinue
if ($lines -notcontains ".godot/") {
Add-Content .gitignore "`n# Godot import cache (regenerated locally)`n.godot/"
Write-Host "Added .godot/ to .gitignore"
} else {
Write-Host ".godot/ already in .gitignore"
}
3. Change import settings in the editor
  1. Select the file in the FileSystem dock.
  2. Open the Import dock (docked next to the Scene dock by default). It shows only the settings relevant to that file's type.
  3. Adjust settings. Changing the Preset (e.g. 2D Pixel vs 3D) flips several options at once toward a sensible default for that use case.
  4. Click Reimport. Select multiple files first to reimport them in one pass when applying the same change broadly.
4. Image import — choose mode per use case
Use caseModeFilterMipmapsNotes
Pixel art / 2D UILosslessNearestOffSet project-wide: Project Settings > Rendering > Textures > Default Texture Filter → Nearest. Pair with "Snap 2D Transforms to Pixel".
3D surface (color/albedo)VRAM CompressedLinearOnUses S3TC/BPTC on desktop, ASTC/ETC2 on mobile.
3D normal mapVRAM Compressed (Normal)LinearOnDedicated normal-map compression avoids artifacts.
HDR / skyboxLossless (HDR)LinearOnKeep full precision for lighting.
5. 3D scene import — glTF 2.0 and .blend
  1. Drop .glb, .gltf, or .blend into res://.
  2. Select the file in the FileSystem dock and open the Import dock.
  3. Set Root Type if the root should be a specific node (e.g. RigidBody3D).
  4. Set Root Scale to match your project's unit convention (Godot 1 unit = 1 meter; Blender default is also 1 meter since Blender 2.8).
  5. Enable Generate > Collisions if the mesh needs physics shapes baked at import.
  6. Configure LODs if the mesh has multiple decimation levels.
  7. Click Reimport. These settings bake into the cached scene — changing them later requires a full reimport.
6. Audio import — format by use case
Use caseFormatWhy
Short SFX (jumps, hits, clicks)WAV (uncompressed)Tiny on disk, zero decode latency, fires instantly.
Music / long tracksOgg Vorbis (.ogg)File-size win outweighs small decode cost. Set loop points manually.
Voiceover (streamed)MP3 or OggStreaming from disk avoids loading the entire clip into RAM.
The engine cannot guess loop points. Unset loop points cause audible gaps at track boundaries. Set them in the Import dock or in the AudioStreamOggVorbis resource's loop_offset property.
7. Resource format — .tres vs .res
  • `.tres` (text): Use for data you want to diff and merge in version control — items, dialogue, tuning tables.
  • `.res` (binary): Use for large or performance-sensitive data where load speed and size matter more than readability.
  • Always check the Error return from ResourceSaver.save(). Silent write failures are the most common resource bug.
8. Headless reimport (CI / clean validation)
powershell
# From the project root on Windows:
# Replace with your Godot binary path if not on PATH.
godot --headless --import --path .
# If Godot is not on PATH, invoke directly:
# & "C:\Program Files\Godot\Godot_v4.x-stable_win64.exe" --headless --import --path .

This reimports every asset from originals + sidecars without opening the editor UI. If it exits with code 0 and no errors in the log, the committed sources are self-sufficient.

9. Runtime loading patterns
Image — texture loading with validation
gdscript
func load_texture(path: String) -> Texture2D:
if path.is_empty():
push_error("load_texture: empty path")
return null
if not ResourceLoader.exists(path, "Texture2D"):
push_error("load_texture: no texture at '%s'" % path)
return null
var resource: Resource = load(path)
var texture: Texture2D = resource as Texture2D
if texture == null:
push_error("load_texture: '%s' is not a Texture2D" % path)
return null
return texture
func apply_character_texture(sprite: Sprite2D, path: String) -> void:
if sprite == null:
push_error("apply_character_texture: null sprite")
return
var texture: Texture2D = load_texture(path)
if texture == null:
return # load_texture already reported why; keep the existing texture
sprite.texture = texture
3D scene — synchronous preload and threaded async load
gdscript
# preload() resolves at parse time, so a missing or corrupt model fails the
# moment this script is first loaded rather than mid-gameplay.
const ENEMY_SCENE: PackedScene = preload("res://models/enemy.glb")
# Large meshes can stall the main thread if loaded synchronously, so stream
# them on a background thread and poll the status.
func spawn_model_async(path: String) -> Node3D:
if path.is_empty():
push_error("spawn_model_async: empty path")
return null
var request_error: Error = ResourceLoader.load_threaded_request(path, "PackedScene")
if request_error != OK:
push_error("spawn_model_async: could not queue '%s' (error %d)" % [path, request_error])
return null
var tree: SceneTree = Engine.get_main_loop() as SceneTree
if tree == null:
push_error("spawn_model_async: no active SceneTree to await frames on")
return null
var progress: Array = []
while true:
var status: ResourceLoader.ThreadLoadStatus = ResourceLoader.load_threaded_get_status(path, progress)
if status == ResourceLoader.THREAD_LOAD_IN_PROGRESS:
await tree.process_frame
continue
if status != ResourceLoader.THREAD_LOAD_LOADED:
push_error("spawn_model_async: failed to load '%s' (status %d)" % [path, status])
return null
break
var scene: PackedScene = ResourceLoader.load_threaded_get(path) as PackedScene
if scene == null:
push_error("spawn_model_async: '%s' did not resolve to a PackedScene" % path)
return null
var instance: Node3D = scene.instantiate() as Node3D
if instance == null:
push_error("spawn_model_async: root of '%s' is not a Node3D" % path)
return null
return instance
Audio — preload and play with guards
gdscript
const JUMP_SFX: AudioStream = preload("res://audio/jump.wav")
@onready var _sfx_player: AudioStreamPlayer = $AudioStreamPlayer
func play_jump() -> void:
if JUMP_SFX == null:
push_error("play_jump: jump SFX failed to preload")
return
if _sfx_player == null:
push_error("play_jump: missing child AudioStreamPlayer named 'AudioStreamPlayer'")
return
_sfx_player.stream = JUMP_SFX
_sfx_player.play()
Resource — typed save/load with .tres and .res
gdscript
# item_data.gd
class_name ItemData
extends Resource
@export var id: StringName = &""
@export var display_name: String = ""
@export var max_stack: int = 1
gdscript
# item_repository.gd
extends Node
func save_item_text(item: ItemData, path: String) -> bool:
if item == null:
push_error("save_item_text: null item")
return false
if not path.ends_with(".tres"):
push_error("save_item_text: expected a .tres path, got '%s'" % path)
return false
var result: Error = ResourceSaver.save(item, path)
if result != OK:
push_error("save_item_text: failed to save '%s' (error %d)" % [path, result])
return false
return true
func save_item_binary(item: ItemData, path: String) -> bool:
if item == null:
push_error("save_item_binary: null item")
return false
if not path.ends_with(".res"):
push_error("save_item_binary: expected a .res path, got '%s'" % path)
return false
var flags: int = ResourceSaver.FLAG_COMPRESS | ResourceSaver.FLAG_BUNDLE_RESOURCES
var result: Error = ResourceSaver.save(item, path, flags)
if result != OK:
push_error("save_item_binary: failed to save '%s' (error %d)" % [path, result])
return false
return true
func load_item(path: String) -> ItemData:
if not ResourceLoader.exists(path):
push_error("load_item: no resource at '%s'" % path)
return null
var resource: Resource = load(path)
var item: ItemData = resource as ItemData
if item == null:
push_error("load_item: '%s' is not an ItemData resource" % path)
return null
return item

Pitfalls

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kayforkind/skill-slice/assets-pipeline/badge)](https://verified-skill.com/skills/kayforkind/skill-slice/assets-pipeline)

Something wrong with this skill or its page? Tell us.