Gsd-skill-creator immersive-environment-design

Design heuristics for immersive environments — VR worlds, AR scenes, CAVE installations, responsive rooms. Covers scale and presence, lighting and atmosphere, sight-line composition, acoustic design, comfort-first layout, player/visitor flow, environmental storytelling, and the boundary between stage and audience. Includes Krueger's VIDEOPLACE heritage, Furness's Super Cockpit discipline, and contemporary guidelines for VR level design. Use when authoring or reviewing any environment whose purpose is to be experienced from within.

install
source · Clone the upstream repo
git clone https://github.com/Tibsfox/gsd-skill-creator
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/spatial-computing/immersive-environment-design" ~/.claude/skills/tibsfox-gsd-skill-creator-immersive-environment-design && rm -rf "$T"
manifest: examples/skills/spatial-computing/immersive-environment-design/SKILL.md
source content

Immersive Environment Design

An immersive environment is one the user is inside, not one the user watches from outside. The design discipline is therefore closer to theater, architecture, and landscape design than to cinematography or graphic design. This skill catalogs the heuristics that distinguish a comfortable, legible, engaging immersive environment from a disorienting or hostile one.

Agent affinity: krueger (responsive environments, VIDEOPLACE lineage), furness (Super Cockpit, high-stakes environments), sutherland (foundational 3D display)

Concept IDs: spatial-reasoning-3d, spatial-structural-principles, spatial-blueprint-design

What Makes an Environment Immersive

Immersion is not a single variable. Slater and Wilbur (1997) separated it into:

  1. Inclusive — the environment surrounds the user
  2. Extensive — multiple senses engaged
  3. Surrounding — wide field of view or spatial audio
  4. Vivid — high fidelity of sensory input

A design can be high on one axis and low on others. A CAVE with 4 walls is inclusive and surrounding but uses a single modality; a full haptic suit with poor visuals is extensive and vivid but not surrounding. Designers choose their axes based on budget and purpose.

Scale and Presence

The first perceptual variable is scale. A VR room that is the "right" size for a virtual human avatar feels present; one that is 10% larger feels subtly wrong, and one that is 2x larger feels cavernous. The designer's job is to match virtual scale to the body the user thinks they have.

Human-scale rules of thumb

  • Ceiling height: 2.4-3 m for residential, up to 6 m for commercial
  • Door width: 0.9-1.2 m
  • Chair seat: 0.45 m from floor
  • Table height: 0.75 m
  • Shoulder-to-shoulder: 0.5 m for comfortable passing, 1 m for easy coexistence

A VR environment that violates these subtly feels off. One that violates them dramatically (a tiny door, a giant chair) feels deliberately surreal.

Lighting and Atmosphere

Lighting is the most powerful tool for evoking mood in an immersive environment. It also has functional consequences: poorly lit environments are hard to navigate and cause eye fatigue.

Functional lighting principles

  • Key light defines the dominant direction. Without it, the scene feels flat.
  • Fill light softens shadows and preserves detail.
  • Rim light separates foreground from background.
  • Ambient light sets the baseline brightness, prevents pitch-black areas from being unwalkable.

Atmosphere via color temperature

Warm (2700K) lighting evokes comfort, interior, evening. Cool (6500K) lighting evokes day, outdoor, sterile environments. Mixing creates contrast: a cold room with a warm lamp in the corner draws the eye.

Fog, particle effects, and god-rays

Volumetric effects add depth and mood but cost performance. Use sparingly in VR where frame rate discipline is critical.

Sight-Line Composition

Unlike film, the designer cannot force the user's gaze. The environment must reward looking in the intended direction without constraining it.

Techniques

  • Leading lines — architectural features (walls, roads, light beams) that draw the eye
  • Focal objects — high-contrast or high-motion elements that attract attention
  • Framing — archways, windows, tree gaps that bracket important content
  • Negative space — empty areas that direct attention to the occupied areas

In VR, designers use these techniques to guide users along a desired path without text instructions or arrows. Good environment design is legible without a mini-map.

Acoustic Design

Audio in immersive environments must be spatialized (positioned in 3D) and environmental (reflecting the space's materials and geometry).

Spatial audio basics

  • HRTF (head-related transfer function) filters sound to create the illusion of direction
  • Distance attenuation — sounds get quieter with distance
  • Occlusion — walls muffle sound from the other side
  • Reverb — large rooms reverberate, small rooms dampen

Functional sound design

  • Footstep sounds tell the user they are walking
  • Ambient room tone makes empty spaces feel alive
  • Interactive feedback sounds close the loop on manipulation
  • Warning sounds use spatial position to indicate direction of threat

Comfort-First Layout

Immersive environments are physical experiences. Designers must account for how bodies will move through them.

Safe zones

The user's physical play space defines the safe zone. Virtual environments should keep important content within reach of this zone. A VR puzzle requiring the user to crouch in a location outside their physical space is a comfort failure.

Locomotion budget

If the environment requires locomotion, the designer must account for motion sickness susceptibility. Provide teleport as a baseline. If continuous locomotion is required (e.g., a flight simulator), front-load comfort options.

Seated vs standing design

Decide early whether the experience is seated, standing, or room-scale. Seated experiences cap head position and simplify interaction. Standing experiences require floor-alignment and ceiling clearance. Room-scale adds the full play-space constraint.

Flow and Pacing

An immersive environment that tries to do too much at once overwhelms the user. Pace the sensory load.

Onboarding moment

The first 30 seconds determine whether the user understands the environment. A calm, legible starting area with clear affordances is essential. Do not spawn the user into action.

Breathers between intensity

Peaks of visual, auditory, or emotional intensity should be followed by quieter recovery moments. The rhythm of a well-designed immersive experience is like a musical composition.

Exit path visibility

The user should always know how to leave. Exit cues (doors, markers, explicit quit gestures) reduce anxiety and improve trust in the environment.

Environmental Storytelling

An environment tells a story through its objects, wear patterns, and spatial organization. Abandoned offices with half-finished coffee cups suggest recent departure. Overgrown ruins suggest long decay. Neatly arranged workshops suggest present occupation.

The designer plants these details deliberately. Players who look closely get rewarded with narrative; players who move past still get the overall mood.

The Stage-Audience Boundary

Every immersive environment must decide whether the user is an actor or an observer. Krueger's VIDEOPLACE put the user in the picture; Furness's Super Cockpit gave the user an instrument panel. Both are valid, but they require different design decisions.

  • Actor mode — user's body is part of the environment, actions have consequences, mirrors and shadows reinforce presence
  • Observer mode — user's body is invisible, actions are metaphorical, environment is legible from outside

A common failure mode is mixing the two without design intent: a first-person environment where the user cannot see their hands, but must interact with precision.

When to Use This Skill

  • Designing VR/AR experiences, CAVE installations, or responsive rooms
  • Reviewing immersive content for legibility, comfort, and mood
  • Selecting lighting, audio, and pacing to match experience goals
  • Training designers migrating from film, games, or architecture

When NOT to Use This Skill

  • Pure 2D screen design (use a 2D UI skill)
  • Interaction design where the focus is input, not environment (use 3d-interaction-design)
  • Abstract data visualization (use a data-viz skill)

Common Mistakes

MistakeWhy it failsFix
Wrong scaleEnvironment feels toy-like or cavernousMatch human-scale rules of thumb
Flat lightingScene feels lifelessUse key/fill/rim discipline
No spatial audioEnvironment feels disconnectedSpatialize at minimum footsteps and room tone
Overwhelming first impressionUser disorientedCalm onboarding moment
No exit visibilityUser feels trappedAlways show a way out
Mixing actor and observer modesInteraction feels brokenCommit to one or the other

Cross-References

  • krueger agent: VIDEOPLACE, responsive environments, gestural interaction lineage
  • furness agent: Super Cockpit, high-stakes environment design
  • sutherland agent: Origins of 3D display and the Sword of Damocles HMD
  • 3d-interaction-design skill: Interaction techniques inside the environment
  • augmented-reality-tracking skill: AR registration when environments mix virtual and real

References

  • Krueger, M. W. (1977). "Responsive environments." AFIPS '77 National Computer Conference.
  • Krueger, M. W. (1983). Artificial Reality. Addison-Wesley.
  • Slater, M., & Wilbur, S. (1997). "A framework for immersive virtual environments." Presence, 6(6), 603-616.
  • Furness, T. A. (1986). "The Super Cockpit and its human factors challenges." Human Factors Society Annual Meeting, 30, 48-52.
  • Sutherland, I. E. (1965). "The ultimate display." Proceedings of the IFIP Congress, 2, 506-508.