build-vesperfall-review-assets

Build transparent PNG and live Three.js model review pairs for game asset catalogs.

5.7k|685|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/MengTo/Skills --skill build-vesperfall-review-assets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-vesperfall-review-assets
Source: https://github.com/MengTo/Skills/tree/main/agent-skills/game-development/build-vesperfall-review-assets
Command: npx skills add https://github.com/MengTo/Skills --skill build-vesperfall-review-assets

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Adding characters, enemies, props, or equipment to a game asset catalog often produces inconsistent media: mislabeled model sources, broken grounding, and review pages that mix cards, canvases, and provenance incorrectly. This Skill standardizes the creation of truthful catalog PNG references paired with live model previews so reviewers can trust what they see.

Core Features & Use Cases

  • Truthful asset pairing: Produces a 512x512 transparent RGBA catalog PNG plus a live Three.js, FBX, or img2threejs model preview with explicit provenance labels.
  • Isolated review routes: Exposes moveset and preview routes with action selection, restart, pause/play, drag rotation, and source-path reporting.
  • Deterministic validation: Ships a validation script that checks PNG signature, dimensions, alpha color type, and model source existence, plus guidance for inventory tests and Codex-browser verification.
  • Use Case: When adding a new enemy to the Vesperfall catalog, run this Skill to generate the transparent card PNG, wire the inspector to the real FBX source, expose a moveset route, and validate everything before committing.

Quick Start

Ask your agent to use the build-vesperfall-review-assets skill to add a transparent catalog reference and live model preview for a new Vesperfall asset, then run scripts/validate_pair.py on the outputs.

Frequently Asked Questions about build-vesperfall-review-assets

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

FAQPage Schema
How do I add a new character to a game asset catalog with a live 3D preview?

Create a transparent 512x512 RGBA PNG for the catalog card, then build a small asset-specific module that loads the real FBX, GLB, or procedural Three.js model for the inspector. Expose an isolated review route with action selection and validate the pair with the provided script.

How to validate a transparent PNG and model source pair in Python?

Run scripts/validate_pair.py with the PNG path and model source path. It checks the PNG signature, confirms 512x512 dimensions, verifies an alpha-compatible color type, and ensures the model source exists with an .fbx, .glb, .gltf, .ts, or .tsx extension.

When should I use img2threejs instead of an imported FBX model?

Use img2threejs only when reconstructing a model in code from a reference image. If a shipped FBX or GLB is the actual runtime source, load that file instead, and never relabel imported geometry as img2threejs in provenance metadata.

Why is my 3D character floating or sunk into the ground in the preview?

Grounding fails when measured from weapon tips, cloth, or VFX instead of foot contact geometry. Measure from foot meshes or authored contact sockets and sample at least nine points across locomotion loops to keep one planted foot at the contact plane.

Can the catalog card render a live WebGL model instead of a PNG?

No. The catalog card must contain only the transparent PNG with zero canvas elements. The live model renderer belongs exclusively in the selected inspector, which hosts exactly one model canvas with a truthful format label.