An AI agent skill that turns any subject into a 3D film or app
Fix the quick prototype instructions found in a fresh-install test: prototype default look, one theme, subject kit, defined folder, which checks apply; give the real Claude Code plugin command; release 0.8.1
Nguyen Xuan Andcf55f0c07f9
diff --git a/README.md b/README.mdindex 7e134c6..6441854 100644--- a/README.md+++ b/README.md@@ -26,7 +26,7 @@ a book or a game. It checks its own frames before it shows you anything.## Start in three steps1. [Install](#install) the plugin.-2. Type `/viz3d` with nothing after it. The agent shows the menu of modes and looks.+2. Type `/viz3d` with nothing after it (`/visualize-in-3d:viz3d` in Claude Code with the plugin). The agent shows the menu of modes and looks.3. Type a mode, a look if you want one, and the subject: `/viz3d film white model the Chernobyl accident`.Put the subject in quotes when it starts with a mode or look word: `/viz3d "film noir city"`.@@ -193,7 +193,7 @@ How you type the command depends on the agent:| Agent | Command ||---|---|-| Claude Code, plugin install | `/viz3d` (or `/visualize-in-3d:viz3d` when another plugin also has a `viz3d`) |+| Claude Code, plugin install | `/visualize-in-3d:viz3d` (Claude Code puts the plugin name in front of plugin commands) || Claude Code, skills folder | `/viz3d` || Codex | `$viz3d`, or pick it from `/skills` || Cursor | `/viz3d` |diff --git a/plugins/visualize-in-3d/.claude-plugin/plugin.json b/plugins/visualize-in-3d/.claude-plugin/plugin.jsonindex 94de776..855f08d 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.8.0",+ "version": "0.8.1","description": "Visualize anything in 3D: places, systems, objects, products, creatures, stories and events, as a documentary or action film, a showcase, a live three.js app with a dashboard, a lesson, an illustrated cutaway book or a playable game, in twelve looks across four families, built from real layouts and models made from real references.","author": {"name": "CodePawl",diff --git a/plugins/visualize-in-3d/skills/visualize-in-3d/references/live-embed.md b/plugins/visualize-in-3d/skills/visualize-in-3d/references/live-embed.mdindex fc79667..a11e886 100644--- a/plugins/visualize-in-3d/skills/visualize-in-3d/references/live-embed.md+++ b/plugins/visualize-in-3d/skills/visualize-in-3d/references/live-embed.md@@ -12,24 +12,30 @@ seeded data to a real feed is a config change.## Quick prototype-Skip Pass 1 and do not ask about Blender. Build everything in one pass in `{{FOLDER}}/app` with the Pass 2 stack+Skip Pass 1 and do not ask about Blender. Build everything in one pass in `{{WORK_DIR}}/<topic>/app` with the Pass 2 stack(Vite, React, React Three Fiber, drei, postprocessing with N8AO) and these cuts:1. **One site, one process.** The topic file lists one site, four KPIs and three to five stages. Leave out the siteswitcher and the film unless the user asks.-2. **A primitive kit, not an asset pack.** One file `src/kit.jsx` with parametric parts at real size: `Box`, `Slab`- (floor with a 3 cm bevel), `Rack`, `Conveyor`, `Tank`, `Pipe`, `Vehicle` (body, cab, four wheels), `Person`- (capsule, 1.75 m), `Building` (walls with window strips, no roof so the inside shows), `Path` (a swept strip along- points). Each takes dimensions and a colour. Build every main asset from the kit against its reference sheet+2. **A primitive kit, not an asset pack.** One file `src/kit.jsx` with the parametric parts this subject needs, at+ real size. For a site with goods and vehicles that is `Box`, `Slab` (floor with a 3 cm bevel), `Rack`,+ `Conveyor`, `Tank`, `Pipe`, `Vehicle` (body, cab, four wheels), `Person` (capsule, 1.75 m), `Building` (walls with+ window strips, no roof so the inside shows) and `Path` (a swept strip along points); a canal lock needs walls,+ gates, water and a boat instead. Each part takes dimensions and a colour. Build every main asset from the kit against its reference sheet(`real-objects.md`): proportions and part count still matter.-3. **The look carries the quality.** Toy isometric from `looks.md`: soft shadows, N8AO, a warm key light, a ground+3. **The look carries the quality.** The look the user named, else the prototype default in `looks.md` (Choosing),+ Clean ops world: soft shadows, N8AO, a warm key light, a groundwith real materials, flat colours from one palette. Clean primitives under good light read as a design choice.-4. **A light UI, motion that explains, three themes**, as the Pass 2 brief says: few plain buttons, no default- dashboard, flows and stages animated, and panels added only when the user asks for them.+4. **A light UI and motion that explains**, as the Pass 2 brief says: few plain buttons, no default dashboard,+ flows and stages animated, and panels added only when the user asks for them. One theme, the look's own palette;+ the three themes come with the full app.+ The 3/4 camera must see into the working part: if a near wall hides it, cut that wall away or raise the camera.5. **Data the leaders recognise.** Ask for a sample export (CSV or JSON) and its field names. With a sample, map itas in "Field mapping" below. Without one, seed a simulation with the real counts and rates from the topic research.6. **Done when** the overview, a clicked unit with its card and each stage preset look right in screenshots, it runs- at 60 fps, and `npm run build` gives a static folder that opens from any web server.+ at 60 fps, the page logs no errors, and `npm run build` gives a static folder that opens from any web server.+ From `self-review.md` run "Each round" and the generic faults that apply to a still view; the film checks apply+ only when the user asked for a film.Budget about 60 tool calls. Report the URL to run it, the screenshots, and what a full build adds (Blender models,film, more sites).diff --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 e6ced38..04625e9 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@@ -272,7 +272,7 @@ reference app (a chip fab with a roof cut away, three.js with react-three-fiber)- Data: every number on the dashboard is computed from the running model, never typed in; the delta and the listschange as the simulation runs.- Film: a virtual clock and real clicks on units and list rows, ending on the world (see `film.md`).-- Traps: a second accent colour, a dark theme, camera too low (loses the cutaway), KPI numbers that do not move.+- Traps: a second accent colour, a dark main look (dark is only the second of the app's three themes), camera too low (loses the cutaway), KPI numbers that do not move.## White model documentary