Skip to content

armgit / viz3d

Public Imported from GitHub
0

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.md
index 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 steps
1. [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.json
index 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.md
index 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 site
switcher 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 ground
with 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 it
as 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.md
index 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 lists
change 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