3Dviz Pro Max
viettranx/3dviz-pro-max · MIT · 404 entries
One agent skill for building 3D scenes and explainers in three.js. It carries a catalog of 223 written recipes, a kit of procedural models, lighting and camera rigs, a starter, and 37 example studies you can run.
- Get it
git clone https://github.com/viettranx/3dviz-pro-max.gitThen link or copy the whole skills/3dviz-pro-max folder into your agent's skills folder, never SKILL.md alone.
- Needs
Nothing to read the skill. Python 3 for the catalog helpers. Node with pnpm or npm for the starter and the examples. Optional: Playwright for its capture script, and Blender 4.2 or newer for its baked hero tier. The six anatomy studies need 169 MB of meshes fetched separately.
- Sends off your machine
Nothing by itself. Two things reach out only when you run them: a script that downloads the anatomy meshes from the author's bucket, and a setting that makes the anatomy studies fetch them in the browser.
- We watched it run
All 37 example studies built in 2.1 seconds, and 31 drew: cottages, a village by day and by night, a cave garden, gears, an orrery, a prism, and line-drawn math studies. The six anatomy studies showed only an error, because their meshes are not in the repo.

The coupled gears study, stepped frame by frame, gave the same picture twice. 96 frames took 25 seconds with software rendering.
- Not tried here
The skill inside an agent, so whether it makes better scenes is untested here. The 223 recipes are text, and the repo says most were never rendered. Everything that needs Blender was read, not run.
- License
MIT
That covers the repo's own code, models and stills. Not covered: the anatomy meshes it downloads (BodyParts3D, CC BY-SA 2.1 Japan, credit required), and one demo recording whose rights the README says are still to be confirmed.
Everything in it
Showing 18 of 404Show everything
Tools
- Blueprint proof harnessA small offline page that loads one kit, lights it with one sun on neutral gray with no post-processing, and stands at four distances…
- blueprint_validation.pyChecks that a blueprint record, its module and its proof captures agree. Maintainer tooling for this repo; not part of the installed skill.
- build-index.pyRegenerates the human-readable catalog pages and the coverage summary from the records; --check fails if they are stale. Maintainer tooling…
- capture.pyServes a built scene from a local port, opens it in headless Chromium, visits its named views, clicks controls you name and writes PNGs and…
- capture_view_quality.pyMeasures whether a captured frame is usable at all: near-black, filled by a wall, or flat. Used by capture.py's --expect-usable.
- catalog_validation.pyThe catalog contract checks used by validate.py. Maintainer tooling for this repo; not part of the installed skill.
- check-docs.pyChecks links and JSON examples in the repo's Markdown. Maintainer tooling for this repo; not part of the installed skill.
- check-retrieval.pyRuns 249 authored search cases against search.py and reports which known intents find their record. Maintainer tooling for this repo; not…
- evidence-log.pyAppends a contract-shaped evidence event and a record snapshot to a change log. Maintainer tooling for this repo; not part of the installed…
- evidence_log_events.pyBuilds the event objects and snapshot paths for evidence-log.py. Maintainer tooling for this repo; not part of the installed skill.
- evidence_validation.pyChecks evidence links and observations for validate.py without certifying that they are true. Maintainer tooling for this repo; not part of…
- kit-proof.pyTurns one blueprint record into four real captures, a proof log with a hash per picture, and an evidence event. Maintainer tooling for this…
- kit_proof_harness.pyAssembles the offline proof page for kit-proof.py with a vendored three: no bundler, no network, no install. Maintainer tooling for this…
- manifest_contract.pyChecks the catalog manifest is one the helpers support before any record path is read.
- migrate-catalog.pyPreviews or applies the one-file-per-record layout while keeping content and search results the same. Maintainer tooling for this repo; not…
- package.pyBuilds repeatable ZIPs of the skill and the Codex plugin; never installs or publishes. Maintainer tooling for this repo; not part of the…
- showcase.pyRenders the 21 showcase stills, one browser at a time, resumable, inside a time budget. Maintainer tooling for this repo; not part of the…
- validate.pyValidates the whole catalog and the public evidence with the standard library: schemas, cross-references, content hashes and proof links…