viz3d ยท diff
git:20261103.3c7c26f to git:20261104.bc2fde5
27 added, 18 removed. Audit A to A.
---
name: viz3d
- description: Start the visualize-in-3d skill from a command, with an optional mode first (app, lesson, prototype, embed, film, action, book, game) and then the subject, for example "/viz3d film the 1906 San Francisco earthquake".
- argument-hint: "[app|lesson|prototype|embed|film|action|book|game] <subject>"
+ description: Start the visualize-in-3d skill from a command, with an optional mode and look first and then the subject, for example "/viz3d film white model the 1906 San Francisco earthquake". With no request it shows the menu of modes and looks.
+ argument-hint: "[app|lesson|prototype|embed|film|action|showcase|book|game] [look] <subject>"
disable-model-invocation: true
---
# viz3d
The user started viz3d with this request:
$ARGUMENTS
In tools that do not fill in the line above, the request is the rest of the user's message.
- 1. Load the `visualize-in-3d` skill and follow it from the start. It is installed next to this one
+ 1. If the request is empty or is `help`, show the menu below as it is, then ask one question: what do you want to
+ make 3D? Stop there.
+ 2. Otherwise load the `visualize-in-3d` skill and follow it from the start. It is installed next to this one
(`../visualize-in-3d/SKILL.md`).
- 2. If the first word of the request is a mode, use that shape and drop the word from the subject:
+ 3. If the first word is a mode, use that shape and drop the word from the subject. Otherwise pick the shape from the
+ subject with the skill's table.
+ 4. If the request names a look, use the matching section of `references/looks.md`. Otherwise use the default look for
+ the shape (looks.md, Choosing).
- | Word | Shape |
- |---|---|
- | `app` | Live app with a dashboard and a short film |
- | `lesson` | Lesson app that builds a real object step by step |
- | `prototype` | Quick prototype from primitives, no Blender |
- | `embed` | Live embed for an existing dashboard, on real data |
- | `film` or `doc` | Documentary film |
- | `action` | Action short |
- | `book` | Illustrated cutaway plate of one subject, or a book of several with quizzes |
- | `game` | Playable browser game, balanced by bot playtests |
+ ## Menu
- Otherwise pick the shape from the subject with the skill's table.
- 3. If the request names a look (ops, toy, lived-in, point cloud, terrain, documentary, white model, pixel, plate, ASCII,
- glow, layer build), use the matching section of `references/looks.md`. Otherwise the skill picks one.
- 4. If the request is empty, ask one question: what do you want people to see?
+ **Modes**, by what you want people to do with it:
+
+ | Watch it | Explore it | Put it in your product |
+ |---|---|---|
+ | `film` or `doc`: documentary film of a story or event | `app`: live 3D app with a dashboard and a 30 s film | `prototype`: quick prototype from primitives, no Blender |
+ | `action`: action short, things fighting, chasing, launching | `lesson`: a real object built and explained step by step | `embed`: live 3D view inside your dashboard, on your data |
+ | `showcase`: a film or stills that show off one object or model | `book`: illustrated cutaway plate, or a book with quizzes | |
+ | | `game`: playable browser game | |
+
+ **Looks**, in four families:
+
+ | Clean product | Real and cinematic | Technical | Stylized art |
+ |---|---|---|---|
+ | ops, toy, lived-in | terrain, documentary, white model, layer build | point cloud, plate | pixel, ASCII, glow |
+
+ Examples: `/viz3d app a container port`, `/viz3d film white model the Chernobyl accident`,
+ `/viz3d showcase glow a cockroach`, `/viz3d game pixel a worm that eats a city`.