kayforkind/skill-slice/assets-pipeline
Claude Code and agent skill by kayforkind/skill-slice
- community
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-pipelineSKILL.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.blendfiles 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
.importfiles, 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.godotfile at the root. - Git initialized in the project root (for
.gitignoreand 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:
- 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)
3. Change import settings in the editor
- Select the file in the FileSystem dock.
- Open the Import dock (docked next to the Scene dock by default). It shows only the settings relevant to that file's type.
- Adjust settings. Changing the Preset (e.g. 2D Pixel vs 3D) flips several options at once toward a sensible default for that use case.
- 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 case | Mode | Filter | Mipmaps | Notes | |
|---|---|---|---|---|---|
| Pixel art / 2D UI | Lossless | Nearest | Off | Set project-wide: Project Settings > Rendering > Textures > Default Texture Filter → Nearest. Pair with "Snap 2D Transforms to Pixel". | |
| 3D surface (color/albedo) | VRAM Compressed | Linear | On | Uses S3TC/BPTC on desktop, ASTC/ETC2 on mobile. | |
| 3D normal map | VRAM Compressed (Normal) | Linear | On | Dedicated normal-map compression avoids artifacts. | |
| HDR / skybox | Lossless (HDR) | Linear | On | Keep full precision for lighting. |
5. 3D scene import — glTF 2.0 and .blend
- Drop
.glb,.gltf, or.blendintores://. - Select the file in the FileSystem dock and open the Import dock.
- Set Root Type if the root should be a specific node (e.g.
RigidBody3D). - 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).
- Enable Generate > Collisions if the mesh needs physics shapes baked at import.
- Configure LODs if the mesh has multiple decimation levels.
- Click Reimport. These settings bake into the cached scene — changing them later requires a full reimport.
6. Audio import — format by use case
| Use case | Format | Why | |
|---|---|---|---|
| Short SFX (jumps, hits, clicks) | WAV (uncompressed) | Tiny on disk, zero decode latency, fires instantly. | |
| Music / long tracks | Ogg Vorbis (.ogg) | File-size win outweighs small decode cost. Set loop points manually. | |
| Voiceover (streamed) | MP3 or Ogg | Streaming 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'sloop_offsetproperty.
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
Errorreturn fromResourceSaver.save(). Silent write failures are the most common resource bug.
8. Headless reimport (CI / clean validation)
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
3D scene — synchronous preload and threaded async load
Audio — preload and play with guards
Resource — typed save/load with .tres and .res
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
- SKILL.md in the repositoryCheckingskills/assets-pipeline/SKILL.md
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
[](https://verified-skill.com/skills/kayforkind/skill-slice/assets-pipeline)