threejs-3d-generator
Skill0 starsChanged 5 months agoMITView on GitHub
Generate, texture, rig, animate, stylize, convert, and download 3D assets for Three.js games using the Tripo API. Use for text-to-3D, image-to-3D, 2D concept to 3D conversion, game-ready GLB/FBX assets, characters, creatures, buildings, props, weapons, terrain pieces, auto-rigging, animation retargeting, model texturing, LEGO/voxel/Minecraft-style stylization, low-poly/quad conversion, and browser asset pipelines. Pair with threejs-image-generator for concepts, texture references, sky/background/terrain textures, logos, icons, and GUI art before image-to-3D generation.
- Reads credentials
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- majidmanzarpour/threejs-game-skillsedited, first seen Sep 28, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- majidmanzarpour/threejs-game-skills★ 2.2k26% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- AGENTS.mdAGENTS.md
- threejs-aaa-graphics-builderSkill
- threejs-audio-generatorSkill
- threejs-debug-profilerSkill
- threejs-game-directorSkill
- threejs-gameplay-systemsSkill
- threejs-game-ui-designerSkill
- threejs-image-generatorSkill
- threejs-qa-releaseSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
18 rules. About 0 are common, 6 are distinctive, and 12 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
12
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 10
Create production-oriented 3D assets, then prepare them for Three.js games.
- Distinctive: line 14
Never store API keys in skill files or client-side game code.
- Very specific: line 33
When the probe says SET but threejs_3d_asset.py reports a missing key, the key is exported in an interactive-only profile (e.g.
- Distinctive: line 39
Use the API only from local/server-side tooling.
- Distinctive: line 51
Run from the user's current project directory:
- Distinctive: line 57
If installed in Codex instead of Claude, use:
- Very specific: line 155
Use threejs-image-generator before 3D generation when the asset benefits from a strong 2D reference:
- Very specific: line 169
Prefer GLB/PBR outputs for Three.js.
- Very specific: line 170
Use GLTFLoader for loading.
- Very specific: line 171
Use AnimationMixer for rigged/animated GLBs.
- Distinctive: line 172
Keep generated model files out of client-side API flows.
- Very specific: line 174
Use generated 3D assets as hero/high-fidelity content, then build surrounding prop kits procedurally or with additional …
- Very specific: line 182
Run animate_prerigcheck first (it takes no model version) and use the detected rig_type for animate_rig and preset selection.
- Very specific: line 192
Use --spec tripo (default) when Tripo presets will be retargeted.
- Very specific: line 194
Only 16 presets exist for v2.5 rigs (no preset:attack.
- Very specific: line 196
After download, run threejs_3d_asset.py validate-animation clip.glb (keyframe QA: flags scale tracks, limb-stretching translation tracks, …
- Very specific: line 198
After download, inspect gltf.animations clip names and counts before wiring the AnimationMixer.
- Distinctive: line 206
Always download output URLs immediately after success.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Three.js 3D Generator
Purpose
Create production-oriented 3D assets, then prepare them for Three.js games. This is the Three.js game system's 3D-generation layer; it uses Tripo as the provider for text-to-3D, image-to-3D, texturing, rigging, retargeting, stylization, conversion, and downloadable GLB/FBX outputs.
API Key
Never store API keys in skill files or client-side game code. The script checks:
--api-keyTRIPO_API_KEY
Step 0 before declaring the key unavailable:
bash ~/.claude/skills/threejs-game-director/scripts/probe_asset_credentials.shFor Codex installs:
bash ~/.codex/skills/threejs-game-director/scripts/probe_asset_credentials.shPaste the literal TRIPO_API_KEY=SET|MISSING output in the report. Do not conclude the key is unavailable from a plain non-interactive shell until this probe has sourced the user's shell profiles.
When the probe says SET but threejs_3d_asset.py reports a missing key, the key is exported in an interactive-only profile (e.g. ~/.zshrc). Wrap script invocations the same way the probe does:
zsh -c 'source "$HOME/.zprofile" 2>/dev/null; source "$HOME/.zshrc" 2>/dev/null; python3 .../threejs_3d_asset.py ...'Use the API only from local/server-side tooling. Generated model download URLs expire quickly, so download outputs immediately after successful tasks.
Tool Script
Reference gate:
- Load
references/api-notes.mdbefore provider API work, endpoint/task decisions, model-version choices, polling, postprocess, conversion, rigging, animation, or download handling. - Load
references/threejs-integration.mdbefore importing Tripo outputs into a browser game or advising GLB/FBX integration. - Load
references/image-generator-workflows.mdbefore pairingthreejs-image-generatorwith this skill for 2D concepts, texture references, UI art, logos, decals, or image-to-3D inputs.
Track required references in a reference ledger with yes/no, path, and failure reason. Do not mark an asset pipeline complete while a required reference is skipped.
Run from the user's current project directory:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py --helpIf installed in Codex instead of Claude, use:
python3 ~/.codex/skills/threejs-3d-generator/scripts/threejs_3d_asset.py --helpCommon Commands
Recommended premium game hero model:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py text \
--prompt "game-ready [hero asset], strong readable silhouette, layered hard-surface detail, PBR materials, clean topology for browser game, centered pivot, 3/4 view, no text" \
--model-version v3.1-20260211 \
--texture-quality detailed \
--geometry-quality detailed \
--wait --download --out-dir assets/models/heroText to 3D:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py text \
--prompt "game-ready sci-fi hover bike, sleek armored panels, readable silhouette, PBR, front facing" \
--model-version v3.1-20260211 \
--texture-quality detailed \
--geometry-quality detailed \
--wait --download --out-dir assets/models/hover-bikeImage to 3D from a local threejs-image-generator concept:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py image \
--image assets/concepts/hover-bike-front.png \
--model-version v3.1-20260211 \
--enable-image-autofix \
--texture-alignment original_image \
--texture-quality detailed \
--wait --download --out-dir assets/models/hover-bikeStatus and download:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py status TASK_ID
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py download TASK_ID --out-dir assets/modelsTexture, rig, animate, or convert:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type texture_model --original-task-id TASK_ID \
--texture-prompt "brushed gunmetal, orange hazard decals, worn edges" \
--wait --download --out-dir assets/models/retextured
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type animate_prerigcheck --original-task-id TASK_ID --wait
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type animate_rig --original-task-id TASK_ID --rig-type biped --spec tripo --wait
# animate_retarget takes the RIG task ID, not the generation task ID.
# Batch up to 5 presets per task via --animations.
# NEVER pass --animate-in-place: it corrupts the bake (mirrored limbs / exploded
# skinning). Strip root motion in the engine instead.
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type animate_retarget --original-task-id RIG_TASK_ID --model-version v2.5-20260210 \
--animations preset:idle,preset:walk,preset:run \
--wait --download --out-dir assets/models/animated
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type conversion --original-task-id TASK_ID --format GLTF \
--face-limit 20000 --wait --download --out-dir assets/models/gltf
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py postprocess \
--type stylize_model --original-task-id TASK_ID --style voxel \
--wait --download --out-dir assets/models/voxelAnimated character pipeline (generation -> prerigcheck -> validated rig with retries -> retargets -> downloads). The pipeline routes itself by body plan: biped characters automatically use the v1.0-20240301 anatomical rig with one FBX per animation (plain preset names are mapped onto the preset:biped:* library); creatures use the v2.5-20260210 rig with GLB clips:
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py character-pipeline \
--prompt "stylized cyber runner character, T-pose, full body, game-ready outfit, readable silhouette" \
--animations preset:idle,preset:walk,preset:run,preset:jump \
--out-dir assets/models/cyber-runner
# Creature example: stance language matters — generate in the pose the preset expects.
python3 ~/.claude/skills/threejs-3d-generator/scripts/threejs_3d_asset.py character-pipeline \
--prompt "stylized wolf, quadrupedal stance, all four legs planted and separated, full body" \
--rig-type quadruped --animations preset:quadruped:walk \
--out-dir assets/models/wolfThree.js Image Generator Pairing
Use threejs-image-generator before 3D generation when the asset benefits from a strong 2D reference:
- Character concept, full-body T-pose/A-pose, front/side/back variants.
- Building, prop, vehicle, weapon, pickup, enemy, obstacle, or terrain tile reference.
- Style sheet for a whole asset family.
- Texture references: terrain, rock, metal, fabric, decals, skyboxes, backgrounds, UI materials.
- Logos, faction marks, pickup icons, hazard signs, cockpit decals, HUD symbols, and GUI panels.
Load references/image-generator-workflows.md for prompt patterns before generating or editing 2D inputs.
Three.js Integration
Load references/threejs-integration.md before importing Tripo outputs into a browser game. In short:
- Prefer GLB/PBR outputs for Three.js.
- Use
GLTFLoaderfor loading. - Use
AnimationMixerfor rigged/animated GLBs. - Keep generated model files out of client-side API flows; generation is a tooling step.
- Inspect triangle count, texture count, material count, file size, scale, pivot, bounds, and animation clips.
- Use generated 3D assets as hero/high-fidelity content, then build surrounding prop kits procedurally or with additional
threejs-3d-generator/threejs-image-generatorpasses.
Rigging and Animation Reliability
Load references/api-notes.md for the full parameter tables. The rules that prevent most failures:
- Generate characters as one fused mesh: keep
--quadand--generate-partsoff (generate_partsdisables texturing;quadforces FBX output). - Require full-body T-pose or A-pose, arms away from body, symmetric, no props fused to the silhouette. Verify the rendered preview is actually in T/A-pose before rigging; regenerate if not.
- Run
animate_prerigcheckfirst (it takes no model version) and use the detectedrig_typeforanimate_rigand preset selection.riggable=falsemeans regenerate with a clearer pose, not force-rig. riggable=truedoes not guarantee a usable rig. After rigging, validate the skeleton before retargeting:threejs_3d_asset.py validate-rig rig-model.glb --rig-type biped(thecharacter-pipelinedoes this automatically). Check both presence AND chain depth: a rig with a 1-bone leg or 2-bone arm warps every clip.- Auto-rigging is nondeterministic. On validation failure, retry the rig task (~25 credits) before regenerating the model —
character-pipeline --rig-retries N(default 2) automates this, and--model-task-id TASK_IDresumes from an existing generation. Armored/hard-surface characters need the most retries; organic meshes usually rig first try. - Creatures get exactly one preset (walk/march). For multi-mode creatures (crawl + fly dragons), rig the same model twice — ground rig type for the locomotion preset,
avianfor wing chains — and drive wings procedurally in Three.js or via external clips on amixamo-spec rig. - Retargeted clips are named
NlaTrack,NlaTrack.001, … in request order — map by index and rename after import. - Rig version is the main quality lever, and it differs by body plan (measured June 2026). The
character-pipelineroutes this automatically; only override--rig-model-versiondeliberately:- HUMANOIDS:
v1.0-20240301(anatomical Mixamo-like skeleton with twist bones + the largepreset:biped:*clip library: idle, walk, run, slash, jump, dances, ...). The v2.x limb-chain rigger went 0/16 on humanoid meshes — armored or not, T-pose or A-pose — always producing asymmetric chains. - CREATURES:
v2.5-20260210(v2.x handles quadruped/avian well: symmetric 5-6 bone chains).
- HUMANOIDS:
- For v1.0 rigs, retarget with
--model-version default(omit the version): the retarget enum rejects explicitv1.0-20240301(HTTP 400 code 2017) but the server default handles v1.0 rigs. - v1.0 retargets must use
--out-format fbx(the script enforces this): Tripo's GLB bake on this path exports twist-bone transforms in the wrong space and limbs collapse into the torso — the FBX of the same task is correct. Load with three.jsFBXLoaderor convert offline. v2.5 creature retargets are fine as GLB. - Use
--spec tripo(default) when Tripo presets will be retargeted;--spec mixamorigs cannot be used with Tripo retarget and are only for external animation pipelines. animate_retargettakes the RIG task ID. Batch up to 5 presets per task with--animations.- Only 16 presets exist for v2.5 rigs (no
preset:attack; usepreset:slash/preset:shoot). Non-biped rig types have a single locomotion preset each; plan extra creature motion procedurally or via external retargeting. - A creature's MESH STANCE drives how presets read: a quadruped walk on an upright-standing dragon looks like a human walking. Generate creatures in the stance the animation expects (horizontal body, all fours planted) — the pipeline only auto-appends T-pose language for biped rigs.
- After download, run
threejs_3d_asset.py validate-animation clip.glb(keyframe QA: flags scale tracks, limb-stretching translation tracks, extreme rotations, and reports per-clip duration/channel coverage), then verify motion visually in the engine. - Never use
--animate-in-place(verified to corrupt clips: mirrored/crossed limbs on v1.0 rigs, exploded skinning on v2.5). Keep root motion baked and convert to in-place at import: zero only the HORIZONTAL components of the root bone's position track, keep vertical (jumps and gait bob live there). Gameplay code then drives locomotion. Exact snippet inthreejs-integration.md. - After download, inspect
gltf.animationsclip names and counts before wiring theAnimationMixer.
Quality Rules
- Improve the user's prompt with material, silhouette, camera/readability, scale, and game-use constraints.
- For riggable characters, include full-body T-pose or A-pose in the prompt or create a T-pose reference image first.
- For Three.js games, request GLB/PBR, reasonable face limits, and texture quality matched to the performance budget.
- For mobile/browser games, favor
smart_low_poly,face_limit, later conversion, or low-poly postprocess when the asset is too expensive. - Always download output URLs immediately after success.
- Report the credential probe output, reference ledger, task IDs, output paths, model version, texture/geometry settings, animations, conversion settings, Three.js import notes, and any missing/failed steps.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

