3dviz-pro-max
GitHub用于设计和构建3D场景、解释性模型及交互式内容的技能,涵盖科学可视化与空间谜题,提供从意图分析到工具选择的完整工作流。
Trigger Scenarios
Install
npx skills add viettranx/3dviz-pro-max --skill 3dviz-pro-max -g -y
SKILL.md
Frontmatter
{
"name": "3dviz-pro-max",
"description": "Design and build expressive 3D scenes, explainers and interactive models with grounded subject knowledge. Use for 3D creation or edits, including scientific visualization and spatial puzzles."
}
3Dviz Pro Max
Use the agent's spatial reasoning, geometry, composition and programming abilities to realize the user's idea. The catalog, kits, rigs and scripts accelerate decisions and construction; they do not set the boundaries of what you can make. A runnable scene still needs visual judgment.
Workflow
For a new scene, work through the decisions below. For an existing artifact, inspect it first and apply only the steps affected by the change. User constraints override suggested tooling and records.
- Intent and visual direction. Identify what the viewer should see, feel, understand or do. Choose a distinctive visual idea, useful references and the intended viewing distance. Decide how shape, material, light, camera and motion work together. Time of day matters for some environments; an anatomical study or mathematical object may need a studio, diagrammatic or invented setting.
- Reason about the important objects. Before selecting a template, identify the silhouette, proportions, parts, connections, surface identity and behavior that make each important object convincing. Use object reasoning and object craft. Solve the hardest or most distinctive object early.
- Ground the representation. Choose illustration, discrete state, simulation or playback; a scene can combine them if their boundaries are clear. For established academic, scientific or technical claims, research the actual passages and fact-check claim → model → rendered result using research and truth. A decorative mesh, imported anatomy or physics engine does not certify a scientific claim. Identify the authoritative state.
- Choose construction per object. Use the routing table below. Search for the missing decision
when useful; do not force a subject into the closest lexical match. Recipes, numerical defaults
and look profiles are candidates to adapt, not instructions to copy every value.
At important joins, decide whether the object needs a continuous skin, a layered covering or
separate articulated parts. Use surface continuity
when attached volumes look accidental; mesh merging is not a universal cleanup prescription.
python3 scripts/search.py "<subject and unresolved decision>" python3 scripts/resolve.py <record-id> python3 scripts/design-context.py "<objective>" --blueprints --look <style-id> - Set quality targets and discover tools. State what the object must withstand at overview,
inspection and close-up distances, including factual fidelity where relevant. Discover available
tools without treating tool availability as artistic quality:
T0–T4 describe the existing kit pipelines and their declared proof status. The legacypython3 scripts/host-probe.py --out host.json python3 scripts/design-context.py "<objective>" --blueprints --host host.json \ --delivery web-desktop --hero <blueprint-id>quality_ceilingfield is a shipped-kit pipeline recommendation, not a limit on custom geometry, external assets, procedural materials or the agent's creativity. A missing kit tier does not prohibit another construction method. Blender availability does not make an object high quality; Three.js-only construction does not make it low quality. - Build a convincing first view. Keep the user's stack. Reuse shared scripts, renderer setup, rigs and scaffold, material utilities and geometry operations where they help. For a large scene or collection, inspect one representative demanding object or scene before multiplying the approach. A kit-shaped prototype should not silently become the finished hero. Author custom geometry, shaders, materials, textures, lighting and interactions as needed. Use Blender for suitable modeling, sculpting, rigging, UV or baking work; use Three.js for suitable procedural geometry, interactive state and rendering. Choose their handoff deliberately. For a distinctive finish, develop palette and material direction from useful references: translate them into part assignments, surface scale and light response. Material refinement can strengthen a good form; keep evaluating shape and attachments separately. When adding or changing directional, practical, day/night or rescaled lighting, read lighting direction and scale before implementing the rig. Identify emitter/receiver ownership and final world scale; choose the artistic treatment freely.
- Make behavior belong to the model. Keep transforms, joints, contacts and controls tied to their authoritative state. Inspect surrounding objects too: a stand needs support, a light ray must stop at an opaque obstacle in its modeled scene, a creature needs clearance. An illustration may simplify physics, but should not accidentally imply a simulation it does not perform. Allocate reusable geometry once where practical; update transforms, uniforms or buffers during motion. Park static scenes and respect reduced-motion preferences. Do not remove identity-defining detail merely to meet an unmeasured budget; optimize what actually costs work. Use subject clarity and meaningful motion when identity, mechanism or control effects are unclear. Explain what changes and stays fixed; keep landmarks, color meanings and readouts synchronized with the visible state. Check local deformation and attachments through relevant extremes, not just the resting silhouette.
- Run and inspect the real output. Build through the project's existing commands, then view
the artifact in an available authorized browser. Inspect overview, meaningful close-ups and the
important interactions. If automated capture is allowed, the optional shared command is:
Addpnpm build python3 scripts/capture.py --dir dist --all-views --click "#control" --out captures--motion-check 2000 --expect-motiononly when the tested state should visibly move.--expect-usablecan flag gross visibility failures; it does not judge art. A visible-browser inspection is valid when headless execution is excluded. Never describe an unobserved frame. For lighting changes, inspect source isolation at fixed exposure, an informative direction change, and any output/reset controls. Check affected receivers and occluders, not just glowing bulbs. Preserve the user's motion and camera choices across lighting modes unless a control promises reset. - Refine by subject and evidence. Use visual review and interaction/frame inspection as conditional prompts. Correct factual errors, broken controls and misleading relationships, then improve the most consequential visual weakness. A failed shape may require a different construction method, not more texture or a higher kit tier. For pinching, detached attachments or repeated pose fixes, use regional deformation diagnosis: solver accuracy, surface deformation and visual quality need separate evidence. Revisit ownership and rig assumptions after changing geometry. Continue useful refinement; reassess an approach that keeps failing rather than applying a fixed number of cosmetic passes.
- Report honestly. Separate what was built, observed, numerically checked and still limited. Build success and collection completion do not establish artistic approval or subject clarity. When describing skill use, distinguish guidance read, records actually retrieved and adapted, custom work and tools run. A skill link alone does not establish dataset use. For substantial deliverables, keep useful decisions in design-system.md, scene-spec.json and validation-report.md when the project wants them. Do not generate paperwork for small edits or user-excluded internal experiments. Document source/asset rights and material scientific limitations where they matter.
Construction routing
| Route | When it helps | What to preserve |
|---|---|---|
| Reuse a kit directly | Its shape, structure, behavior and finish already fit the actual brief | Inspect it at the intended distance; a kit can be a hero when it fits |
| Adapt a kit or compose reusable parts | Common construction is useful, but identity or behavior differs | Change silhouette, proportions, joins, materials or articulation; recoloring alone may not suffice |
| Author custom geometry/materials/rigs | A distinctive hero, analytical form, reference or mechanism needs another solution | Reuse low-level operations and tooling; custom does not mean rewriting infrastructure |
| Use a suitable external asset | Authored/scanned/source geometry fits the subject better than reconstruction | Verify provenance, rights, scale, registration, topology and what the asset actually represents |
| Combine methods | Different parts or roles benefit from different approaches | Keep style, scale, state ownership and interfaces coherent |
Neither hero/background role nor Blender/Three.js decides the route by itself. Reuse the mechanism of construction freely; reuse a finished shape only when it fits. An absent dataset entry means a coverage gap, not an unavailable technique. No special justification is owed for creative freedom.
Read only what helps
- Catalog: candidates by topic; coverage and gaps are explicit.
- Conditional reasoning: model and verification choices.
- Physical interaction: support, clearance, contact and causality.
- Motion and state: playback, articulation and interactions.
- Design synthesis: a coherent visual system without uniform objects.
- Kits: reusable blueprints and scoped pipeline proofs.
- Blender/Three.js handoff: tool responsibilities and asset transfer.
Small edits
Inspect and change the affected behavior or visual directly. Preserve working interactions and the user's choices. A text, color or small geometry edit does not require a new scene or full workflow.
Version History
- d077e0e Current 2026-09-21 23:52


