asset-pipeline
Turn generated or hand-made art into exactly what a game engine loads. Covers sprite cutout, trim and nearest-neighbour fitting to frame sizes, pixelation to a palette, sprite sheets and strips, player/team-colour masks, seamless textures, and rendering a 3D model into sprite frames from the game's own camera (isometric/RTS 8 or 16 headings, side view, top-down) with Blender. Use after generating assets, or when the user asks to make sprites, sprite sheets, animation frames, isometric unit sprites or icons for a game.
- Installs
- 1.5K
- Last 24h
- +20
- Trending rank
- #5749
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/rehan-remade/universal-modder --skill asset-pipeline- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads asset-pipeline automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Asset pipeline: from art to engine-ready files
The fal-assets skill makes pictures. This skill makes files the game accepts: the right size, frame
layout, orientation, alpha, palette and format. All commands are um sprite ... and um render3d ...; each
has --help with examples.
1. Learn the target format from the game itself
Before converting anything, open two or three of the game's own assets and write down in MODLOG.md:
- Dimensions: frame size, frames per sheet, and the layout (vertical strip / grid / one file per frame).
- Orientation: which way the art faces (Terraria: items point right, NPCs face left, the engine flips them), and where the pivot or hotspot sits (AoE2: the unit's ground point at the canvas centre).
- Alpha: hard 1-bit edges (BC1 punch-through, pixel art) or soft.
- Style: palette size and outline (dark 1-2 px outline in most pixel-art games).
- Format: PNG, DDS BC1/BC3/BC7, XNB, SLD, atlas + JSON...
The draw code is the final authority. In Terraria, NPC frame height = texture height / Main.npcFrameCount,
so any consistent frame size works.
2. 2D pipeline
um sprite info raw.png # size, alpha coverage, corner colour
um sprite cutout raw.png cut.png # flat bg → transparent (border flood fill keeps interior whites)
um sprite cutout raw.png cut.png --grey 150 --keep-top 0.8 # also remove a soft grey shadow / the floor under it
um sprite fit cut.png item.png --size 64x26 --hard-alpha # trim + ONE nearest-neighbour scale into the frame
um sprite fit cut.png npc.png --size 38x34 --anchor bottom # standing sprites sit on the frame's bottom edge
um sprite pixelate cut.png px.png --size 32x32 --colors 16 --outline # true pixel art from painterly art
um sprite palette px.png px2.png --from stock_sprite.png # snap to the game's own colours
um sprite frames npc.png frames/ --n 3 --kind bob # cheap idle animation (bob/squash/wobble/flash)
um sprite sheet sheet.png frames/*.png --vertical # Terraria-style strip (or --cols N grid)
um sprite slice sheet.png out/ --frame 32x32 # the other direction
um sprite team-mask unit.png unit_grey.png --hue blue # player-colour mask (+ desaturated sprite)
um sprite preview item.png look.png --scale 6 # checkerboard + zoom: LOOK at it before shipping
- Pixel art: scale once, with nearest neighbour, to the final size. Never scale pixel art twice.
- Painted / HD art: use
fit --smooth. - Real frames: for animation frames beyond bob/squash, generate each frame with the fal edit endpoint using the base sprite as reference ("same drone, rotors tilted, frame 2 of 4"), then cut out and fit each frame the same way. Or go 3D (below).
3. 3D → sprites (consistent angles and animations)
um fal model3d concept.png --name unit # textured GLB (Trellis 2 by default)
um render3d assets/gen/unit.glb frames/ --preset aoe2 --length 80 --forward-yaw -90 \
--anims idle:10:bob,walk:12:walk,attack:16:lunge,death:20:die --shadows --samples 40
um render3d assets/gen/unit.glb side/ --preset side --canvas 128 --length 110 --engine eevee # platformer facing R + L
Presets:
| Preset | Projection | Camera | Facings |
|---|---|---|---|
aoe2 | ortho | 30° | 16 clockwise from east |
iso8 | ortho | 30° | 8 |
trueiso | ortho | 35.264° | 8 |
topdown | ortho | — | 8 |
side | ortho | — | 2 (right, left) |
turntable | persp | — | 24 (promo/icon spins) |
--lengthsets the model's longest horizontal side in pixels at 1x, so match stock units.--forward-yawturns the model so its nose faces +X; check the first frame.--shadowsadds a shadow-only pass (*_s.png) for engines that keep shadows in their own layer.- Motions: bob, walk, lunge, die, wreck, spin.
- Then pack with
um sprite sheet, or with an engine writer (e.g.examples/aoe2-de-civ/sld.py). - Needs Blender (
blenderon PATH orBLENDER=...). Cycles uses the GPU when available. - Dark generated textures: raise
--sun/--ambient, or brighten in post. - For game-ready 3D (not sprites), remesh with
um fal run tripo3d/tripo/remesh mesh_url=@unit.glb face_limit:=8000, then convert in Blender (GLB → FBX/OBJ) with the engine's scale and axis convention: Unity Y-up metres, Unreal Z-up centimetres, Bethesda NIF via PyNifly.
4. Textures and materials
- Tiling:
um fal texturegenerates it tiled. Check withum sprite tile-preview t.png t3.png. Fix seams on other images withum sprite seamless. - PBR sets:
um fal pbr. Convert to the engine's packing: Unreal ORM (occlusion/roughness/metal in RGB), Unity metallic-smoothness (smoothness = 1 - roughness in alpha). - DDS: texconv (DirectXTex) or
magickwith DXT settings. BC7 for quality, BC1 for cutout sprites, BC3 when alpha is soft.
5. Verify in the game
Put one converted asset into the game and screenshot it next to stock art (um win shot). Check the scale,
facing, pivot, outline and palette. Fix the recipe, then batch-convert the rest with the same commands (a
small script or Makefile, so the pipeline is reproducible from assets/gen/).
6. Converting a guest game's Unity assets (mashups)
Read the user's own install with UnityPy and write a local, private resource pack. Never put the output in the mod, its repo or a release; each user runs the converter on their own copy.
- Memory:
UnityPy.load()decompresses a whole bundle (a 865 MB bundle became 8.7 GB of RAM). Decompress only the serialized files and read.resS/.resourcelazily, block by block; run each converter module in its own process. - Environment:
UnityPy.Environment(path=""), and load cross-referenced bundles together; otherwise UnityPy searches the working directory for missing dependencies. - Finding assets: Addressables bundle names are hashed per update (find them by prefix); Addressables
2.x has a binary
catalog.bin. Map game objects to prefabs through their GUID keys, not by guessing names. Prefer the low-quality variant if one exists (same meshes, smaller textures). - Skinned meshes are stored in bind pose (often a T-pose). For the in-game look, evaluate the idle clip at t = 0 yourself (UnityPy reads AnimationClip objects but does not sample them; Generic clips bind Transforms by CRC32 of the path), rebuild world matrices, then skin.
- Walk the hierarchy from the container root, skip inactive GameObjects and their children, and drop helper meshes (eyelids, ground shadows, stencil/outline materials).
- Axes: Unity is left-handed, Minecraft right-handed: flip one axis for positions and normals and reverse the winding; flip V; clamp UVs. Verify with a named bone (the right hand ends on the right).
- Shared atlases: crop each part's texture to its UV bounding box and remap UVs.
- Audio:
AudioClip.samplesneeds FMOD (fmod_toolkit); encode with ffmpeg to mono OGG. - Minecraft side: a pack needs
pack.mcmeta(pack_format15 for 1.20.1);ResourceLocations accept only[a-z0-9_./-]. For posed meshes, a custom mesh file drawn withRenderType.entityCutoutNoCullis more robust thanforge:obj(block-atlas textures,usemtl). - Oracle: render preview sheets by re-reading the files you wrote, and look at them.
FAQ
What does the asset-pipeline skill do?
Turn generated or hand-made art into exactly what a game engine loads. Covers sprite cutout, trim and nearest-neighbour fitting to frame sizes, pixelation to a palette, sprite sheets and strips, player/team-colour masks, seamless textures, and rendering a 3D model into sprite frames from the game's own camera (isometric/RTS 8 or 16 headings, side view, top-down) with Blender. Use after generating assets, or when the user asks to make sprites, sprite sheets, animation frames, isometric unit sprites or icons for a game.
How do I install asset-pipeline?
Run npx skills add https://github.com/rehan-remade/universal-modder --skill asset-pipeline in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/asset-pipeline/ (personal) or .claude/skills/asset-pipeline/ (project).
Which AI agents can use asset-pipeline?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is asset-pipeline safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains asset-pipeline?
It is published by rehan-remade in rehan-remade/universal-modder. It has 1,509 recorded installs.
More from rehan-remade/universal-modder
mod-any-game
rehan-remade/universal-modder
Mod a PC game the user owns, taking an idea to working in the real game and recorded. It covers new items, weapons, enemies, bosses, units, civilizations, mechanics, art, sound, VR and cross-game mashups. Use when the user wants to mod, extend, hack on, reverse engineer or mash up a game ("add a nuke to Terraria", "make a new civ for Age of Empires", "put Minecraft inside X", "can I mod this game?"). It covers recon (engine, loaders, anti-cheat), choosing the route, a safe lab, a first vertical slice, fal-generated assets, in-game verification and a showcase clip.
reverse-engineering
rehan-remade/universal-modder
Read how a game actually works so a mod can hook it. Decompile .NET/Mono (ILSpy), IL2CPP (Cpp2IL, Il2CppDumper), Java (Vineflower) and native code (Ghidra, IDA, via MCP servers); dump data and asset formats; reverse-engineer a binary file format and prove it with a round trip; read live memory (Cheat Engine, Frida, x64dbg); find render passes (RenderDoc). Use when a mod needs game internals, e.g. "how does the boss AI work", "find the damage function", "what format is this .sld/.pak/.dat", "where is the player position in memory".
game-recon
rehan-remade/universal-modder
Figure out how a specific installed game can be modded, before writing any mod code. Covers where it's installed, the engine and version, managed vs native code, anti-cheat, loaders already present, save and config folders, and the community's modding route. Also whether this machine can run it (a Windows game on macOS or Linux, x64 on ARM). Use when the user asks "can I mod ?", "what engine is ", "how do people mod ", or at the start of any modding task. Produces MODDINGPLAN.md.
game-automation
rehan-remade/universal-modder
Launch, see and drive a real game so an agent can test its own mods. Covers launching via Steam or the exe, windowed mode at a fixed size, screenshots of the game window (GPU-safe capture), clicking and typing into menus, holding keys, relative mouse, crash-reporter cleanup, killing by PID, reading logs, scripted test scenes, and an in-game JSON bridge that lets an agent observe and act. Windows-first (also from WSL), with notes for Linux and macOS. Use when a mod must be verified in game, when navigating menus automatically, or when building a repeatable test or demo scene.
mashup-mods
rehan-remade/universal-modder
Build cross-game mashups and total conversions, the "Minecraft inside Elden Ring" or "skateboarding in MW2" kind. Covers passthrough mods (two games running at once and exchanging state, rendering and collision), porting one game's content or mechanics into another, embedding a decompiled game as a library, and clean reimplementations that read the user's own game files. Use when the user wants to combine two games, bring an enemy, mechanic or world from one game into another, or rebuild a game's runtime, or reimplement the guest's rules headless inside a real host.
share-field-notes
rehan-remade/universal-modder
Search and contribute to the shared AI-modding knowledge base, where field notes record how specific games were modded, decompiled or reverse-engineered (exact versions, route, engine facts, verification, gotchas). Use before starting work on a game ("has anyone modded X?"), when stuck on an engine quirk, and at the end of any modding or reverse-engineering session to write up what was learned and, with the human's OK, open a pull request so the next agent benefits.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image