An AI agent skill that turns any subject into a 3D film or app
Add layer build film look, neon bloom note and sim-film review checks; release 0.4.5
Nguyen Xuan An0e514213b811
diff --git a/plugins/visualize-in-3d/.claude-plugin/plugin.json b/plugins/visualize-in-3d/.claude-plugin/plugin.jsonindex afcc41f..bb27609 100644--- a/plugins/visualize-in-3d/.claude-plugin/plugin.json+++ b/plugins/visualize-in-3d/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "visualize-in-3d",- "version": "0.4.4",+ "version": "0.4.5","description": "Turn hard-to-picture places, systems, objects and events into a 3D world you can watch, learn from or click through: a live three.js app with a dashboard, a lesson app, a documentary film, or an illustrated cutaway book, built from real layouts and models made from real references.","author": {"name": "CodePawl",diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/SKILL.md b/plugins/visualize-in-3d/skills/visualize-in-3d/SKILL.mdindex 3d6b0c3..76b4b12 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/SKILL.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/SKILL.md@@ -63,6 +63,7 @@ people unless the user asks for real ones. For a real named place, follow "A reaModels follow `references/asset-sources.md`: ready models first, then scans, packs, AI-generated models, andBlender builds from a reference sheet (`references/real-objects.md`). The pass reports stills at film scale.+A review loop that reads many frames runs them through a `frame-reader` agent; open only the frames a decision hangs on.## 4. Pass 2: build and film, with the self-review loopdiff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/looks.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/looks.mdindex 8e04481..2650cee 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/looks.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/looks.md@@ -3,7 +3,8 @@Each topic file names one look. The look sets the world's rendering, the UI skin and what the film shows; the datamodel, the dashboard parts and the film's click-driven shape stay the same. Reading map: Toy isometric (default),Point-cloud survey, Photoreal terrain analysis, Dark documentary, Pixel diorama, Illustrated cutaway plate,-Lived-in isometric, Dither + ASCII showcase, Gradient glow ASCII, Clean ops world, Choosing.+Lived-in isometric, Dither + ASCII showcase, Gradient glow ASCII, Clean ops world, White model documentary, Layer+build film, Choosing.Reference stills or clips for a look are optional. If you have some, save them under `{{WORK_DIR}}/references/<slug>/`and point the briefs at them; they are for study only and never ship in the app or the film. Without them, the@@ -78,6 +79,10 @@ frames, music or text). Fits a case file or a piece of history: a crime, a disapsilhouettes: white for the victim or witness in focus, blue for police, translucent grey for others. Unlit one-colourmaterial on a rigged base mesh works, with a flat tapered tube from chest to below the hips so the bare waist and hips donot read as a naked muscled body, and the head held up when bending so the outline keeps a head.+- Neon on the dark picture: bloom filters on luminance, so pure red never reaches it, and a stronger bloom only fogs the+ black. Lift bright saturated colour above 1 in a pass of its own before the bloom (an effect merged into the bloom's pass+ does not feed it), raising the strongest channel and pressing the others down, or red clips to pink. Leave orange and+ yellow out, or pencils and lamp-lit wood glow.- Labels: small boxed captions in spaced caps with thin leader lines (`PC THOMAS BARRETT`, `SUSPECT`), red dots atthe anchor; a thin red timeline across the top with times and events (`04:45 BODY IS FOUND`), a note that timesare approximate.@@ -287,9 +292,33 @@ A case told as an architect's model: studied from LEMMiNO's documentaries and bu- Traps: exposure blowing the floors white, mapped surfaces staying dark, fades that lose their references when materials arereplaced instead of changed, a light multiplier applied every frame to a value set only once.+## Layer build film++Reference: a Blender city breakdown film. One locked aerial camera, and a place is built up in layers until the last+one is a finished, cinematic frame. No labels and no narration: the picture alone says what each layer added.++- Order: live city teaser with a moving camera, a 1.4 s slide to the bare first layer (a hard cut plus falling blocks+ made the viewer jump, a fade looked soft), masses rise from the ground, facade detail, roof props, a viewport look with a+ wire sweep and a wire-only beat, clay, materials wipe on building by building, traffic, turntables of two heroes,+ sun move, signs light, four pass panels (albedo, sky, normal, sun), atmosphere, a long push along the street on the final, ending in the shot with no text card.+- Rendering in three.js: every output frame is an average of many renders (jittered sun passes, sky dome passes,+ sub-pixel camera jitter, shutter time for motion blur) in half-float targets. Then ray-marched shafts through a sun+ depth map, depth haze, a steam layer, bloom, a filmic grade, grain. 8 sun and 24 sky passes hold at 1080p.+- Hero frame: camera about 42 degrees down, not 64, and a raking sun so tower shadows fall across the street. Depth+ comes from hard shadow with light haze only: a low sun along the street with thick haze reads as a milky toy. Most of+ the frame sits in open shade, median luminance about 0.2 with little clipped (0.1 and heavy grime read as dark and dirty). Start the shaft march well away from the+ camera, or the air there lays a veil over the whole frame.+- Air detail: derive every smoke plume from the prop that makes it (rooftop pipe, street steam chimney), one wind for+ all, tight at the mouth. Dust and litter are real geometry in the averaged scene, so they take sun, shadow and blur.+- Scale and wear decide whether it reads as a real city: streets at real width with dense traffic, stained roofs,+ colour bands, blinds and fire escapes on walls, and signs lit by the scene, muted and dirty, never brighter than the+ roofs beside them. Compare luminance percentiles against the reference before calling a look finished.+- Sound: one recording per action, placed from the film's own event times; a real track whose surge lands on the+ final layer.+## Choosing-A case that needs its action and places clearly seen can go white model documentary; dark documentary suits a case that lives on+A build-up or breakdown of a place, where the wow is watching it become real, goes layer build film. A case that needs its action and places clearly seen can go white model documentary; dark documentary suits a case that lives onwhat stays hidden. Clean ops world is the default for a system that runs (an operation with units, tasks and flows). Toy isometric (amore playful diorama on a slab, stronger colour) stays as an alternative when the user asks for it or the subject islight-hearted. A showcase film always uses dither + ASCII with the modeldiff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/self-review.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/self-review.mdindex d7968d0..cc6245f 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/self-review.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/self-review.md@@ -30,6 +30,8 @@ Reading map: read "Every film" always, then only the groups that match what youRead always.+- Moving parts that clip into static ones: a vehicle or rail passing through a tool, a support post through a machine. Measure the clearance in code from the model bounds and require it above zero before looking at frames (Session Fab, 2026-10-31: OHT legs sunk through tool roofs and An called it glitching).+- A refine or remake of a film is shown before it stands next to the old film, frame against frame at the same moments. Better parts do not count if the whole film reads worse (An, 2026-10-30: "sao nó tệ hơn trước vậy").- "More realistic" came out as dirt: blotchy tiled ground filling the frame, stains on the skin, grey gloom, over-reflective glass. Realism comes from shape, clean light and soft shadows; keep the stage calm and bright unless the subject asks otherwise.- The camera hides what the step is about: a lowered flap seen from above and ahead sits behind the wing and only its track fairings show, as spikes. Film a moving part from the side where it moves into view.@@ -67,6 +69,11 @@ Any shot with a moving camera.Interactive apps, dashboards and their films.+- The film spends its time dragging the time scrubber. Allow one short drag at most; the cursor works inside the world: hover, click a machine, follow a unit (An, 2026-10-31).+- A moving unit gives no sign of where it is going, or a machine's state cannot be read at a glance. Draw each unit's path along its real route, and give running, idle and fault marks of different shapes, all from sim state (An, 2026-10-31).+- A stretch of more than about 2 s where the cursor and camera hold still while the script waits for the sim. Speed it up in the edit or wait before recording starts (Session Fab round 3 waited 5 s for a walker).+- A sound cue for an event that is off screen. A sim's event log covers the whole site, so check each cue against the frame at its time.+- Too many controls on an interactive page: panels in several corners, labels on every object at once, controls overthe subject. Use one dock at the bottom, one menu open at a time, and labels only for the current step. A phone cardmust leave the subject in view.@@ -98,6 +105,12 @@ Interactive apps, dashboards and their films.Use big friendly units in the subject's own brand colours (a mascot-like bot for software), a different stationdesign per role with a label sign, the links between stations drawn by their real volume, and open on the fulloverview.+- A click in a film that lands on the wrong thing or on nothing (2026-10-31, warehouse: the camera stayed on a forklift+ after clicks meant for a line and a dock, and another forklift's hit box caught a third). Read the selected unit after+ every scripted click and fail the take on a mismatch. Give the app a real way back to the overview for the cursor to use.+- A close-up that lands on an idle unit or behind a prop (same film: an empty belt, an empty dock, a forklift hidden by+ its rack). Give each kind of unit a view that shows its work, and search the seed for the pre-roll where each unit is+ busy on the second it is on screen, instead of hoping a live sim obliges.### Books and illustrated plates@@ -237,12 +250,24 @@ Rain, water, beams.from the lens, fade it along its length and toward its edge, add faint haze noise and motes, and let the hand drifta little. Guard the shader against NaN (pow of a negative, normalize of zero): one NaN pixel through bloom turns thewhole frame black.+- A jump scare nobody planned: a level jump of more than about 12 dB within a second, usually near silence before a hit.+ Print half-second levels of the final mix; do not trust a cue's own check, which passes because the hit is loud.- Rain that falls as one uniform slant: every streak tilted by the same wind vector, same length and brightness. Keeprain near vertical, give each drop its own lean, speed, length and brightness, and let gusts move across the scene.+- A whole frame washed pale or milky. Split it into albedo, sky and sun before touching materials: pale roofs in a city+ film came from a solid coping box sitting on every roof like a lid, and a milky veil came from light shafts marched+ from the camera instead of from a distance.+- Smoke or steam that starts in mid air, or a plume with nothing under it. Crop each mouth at double size: every plume+ must start at a visible pipe, stack or vent, and all plumes lean the same way.+### SoundAny film or app with audio.+- A generated recording asked for 3 s that is really 0.6 s of sound and then silence, while the picture keeps going.+ Measure each cue's level over time; a long action gets several recordings, not one stretched hope.+- A bright line on the mix sheet is not yet a fault: the spectrogram is log scale. Measure that band per stem first. A+ 14 kHz line that looked like a whine was -68 dBFS, inside the music track.- Loud, hissy foley on a gentle action, such as leaf-rustle recordings used for page turns. Keep paper foley soft andlow-passed under the music, with few snaps, never louder than the beat it marks.