EverettFish/holo-card-studio

Holo Card Studio is a Codex skill that turns a single natural-language prompt into a browser-viewable 3D holographic trading card — complete with parallax depth, rainbow laser shimmer, and a flippable back face. The mechanism is a four-layer image stack: background, subject, lineart, and text, each assigned a different depth value so that as you drag the card in the browser, the layers appear to float at different distances from the screen. Three.js reconstructs the same UV math that Blender uses, which is why the rendered preview and the interactive webpage look identical.

The skill handles its own tooling. Blender is downloaded automatically as a portable build, SHA-256 verified, and stored inside the project directory — you never touch a system-wide installation. Python with Pillow handles the image layers; Node.js serves the viewer. The deliverables are concrete: a local web link you can drag and tilt immediately, a card.blend with Chinese-labeled material nodes for parallax intensity, laser stripe density, lineart glow, and Voronoi starfield scale, plus the four source PNGs and a card-config.json for rarity, numbering, and display text.

A newer lenticular mode adds a second card face. Rather than splitting one image into alternating strips, it uses two complete card faces — image A and image B — that swap as the viewing angle changes. When a reference image is provided, the second face is generated using the first as an identity anchor, locking face shape, proportions, costume details, and camera framing before diverging the composition. The Blender scene for this mode adds a physical lenticular lens layer, a holographic film layer, outline lighting, and a diamond-sparkle particle system. The web viewer loads a GLB exported from Blender and drives the full-card switch with the same tilt formula used for mouse and touch input.

The README is written entirely in Chinese, with an English translation linked but living in a separate file. The gallery distribution feature — a waterfall-layout showcase with permanent per-card URLs and auto-generated filters by character, style, theme, and rarity — depends on a companion repository that is currently private and requires owner authorization to access.

What makes this interesting for anyone building generative tooling is the deliberate design choice to keep the skill itself weightless: only code and text live in the skill directory, while all generated assets stay in the user's own output project. The packaging script enforces this by whitelisting only text files when building a shareable ZIP. The Blender material nodes are named in plain Chinese so that the .blend file doubles as a readable reference for how holographic shimmer actually works — not just a black-box output.