An AI agent skill that turns any subject into a 3D film or app
Film: planning, holds, cutaways and frame checks from the metro test build
Nguyen Xuan Anbff147d036aa
diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.mdindex e613cfc..79ac6f2 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/brief.md@@ -41,7 +41,8 @@ UVs, PBR materials (small procedurally baked textures are fine), emissive wherematerial per state, so the app can toggle it. Two to four variants of anything that repeats more than about fivetimes (vehicles, people, trees, buildings); one model is fine for unique structures. Moving parts are separate named objects or bones with their pivot at theorigin (wheels, doors, fans, lifts, booms, bridges, character limbs); characters and animals get an armature with-named clips (vertex groups per bone, an Armature modifier, clips on NLA strips); render one posed frame of each clip+named clips (the app plays clips per figure, or for crowds uses a few baked pose meshes per clip, since three.js+instancing does not skin) (vertex groups per bone, an Armature modifier, clips on NLA strips); render one posed frame of each clipto check the bone axes. Build repeating structures (track, platforms, sheds) on one module length that fits the realthing, and write it into ASSETS.md. Keep the total under about 40 MB (10 MB is typical), one GLB per asset family so repeats can be instanced.Set single-sided materials (backface culling on), so the exported glTF is not doubleSided.diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.mdindex 0fbaecb..9db7924 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/film.md@@ -62,6 +62,17 @@ leans on them most. Reading map: Pacing and text, Camera, Figures and places, Mathen the script pre-rolls the simulation a whole number of seconds and captures one screenshot per 1/30 s step.Encode the frames with ffmpeg afterwards.- The simulation steps only from the virtual clock, never from wall time, so the same seed gives the same film.+ Step CSS animations and transitions with the same clock (document.getAnimations(), set currentTime), and read the+ simulation time at the first captured frame instead of assuming the pre-roll landed exactly.+- Plan the film from the simulation: a small script runs the seed forward and picks the hero unit and the times, so+ the unit you click is moving and on screen at that moment.+- During a follow or a hold, keep a slow real drag-orbit or wheel going. A followed unit that stops (a train at a+ platform) otherwise gives repeated frames. Find them with ffmpeg mpdecimate plus showinfo and fix every gap over+ 0.2 s.+- The subject must read at film size: the main moving unit fills at least a quarter of the frame width in the+ opening and the follow beat. Context (a city, terrain) never outweighs the system the film is about.+- When the system is hidden (underground, inside a building, behind a roof), cut it open: a clean section through+ the ground or the walls, with the camera-side scenery removed or ghosted, and real materials on every cut face.- Each beat's hero event (a unit reaching a booth, a truck under a gantry) must happen inside its beat. Spawn the heroat a fixed simulation time so it lands 2 to 3 s into the beat, and check it on the sheet.- A plain-words strip carries one short line at a time, on the caption timer above.diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh b/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.shindex cd23056..f79069f 100755--- a/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/scripts/contact-sheet.sh@@ -28,5 +28,5 @@ ffmpeg -v error -i "$video" \-vf "fps=${frames_per_second},scale=${scale},drawtext=text='%{pts\:hms}':x=8:y=8:fontsize=18:fontcolor=white:box=1:[email protected],tile=5x4:padding=4:color=black" \-q:v 3 "$output_folder/sheet_%02d.jpg"-echo "Sheets in $output_folder (newer than $video: check before trusting them)"+echo "Sheets in $output_folder"ls -l "$output_folder"/sheet_*.jpg