Gsd-skill-creator spatial-reasoning-fundamentals

Spatial reasoning fundamentals for three-dimensional thinking, coordinate navigation, mental rotation, cross-section visualization, and voxel geometry. Covers the cognitive primitives that underlie block-based world-building, CAD modeling, volumetric design, and VR/AR navigation — egocentric vs allocentric frames, cardinal orientation, chunk boundaries, symmetry classes, and the translation between paper blueprint and in-world construction. Use when teaching or applying 3D spatial thinking in any spatial computing context.

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/spatial-reasoning-fundamentals" ~/.claude/skills/tibsfox-gsd-skill-creator-spatial-reasoning-fundamentals && rm -rf "$T"
manifest: examples/skills/spatial-computing/spatial-reasoning-fundamentals/SKILL.md
source content

Spatial Reasoning Fundamentals

Spatial reasoning is the cognitive substrate beneath all spatial computing. Whether the user is placing blocks in a voxel world, sketching in a CAD program, navigating a VR environment, or planning a building from a blueprint, the same core abilities are in play: holding a three-dimensional model in working memory, translating between viewpoints, and predicting how geometry behaves under transformation. This skill catalogs the cognitive primitives, failure modes, and teaching heuristics that make spatial reasoning transferable across spatial computing platforms.

Agent affinity: sutherland (coordinate frames and display geometry), engelbart (navigation and viewpoint), papert-sp (constructionist scaffolding)

Concept IDs: spatial-coordinate-navigation, spatial-reasoning-3d, spatial-geometric-structures

The Cognitive Primitives

PrimitiveWhat it isWhy it matters
Coordinate framingAnchoring position to an origin plus three axesWithout a frame there is no "here" and no "there"
Mental rotationRotating an object in imagination to compare with a targetEvery build-from-reference task requires it
Cross-section visualizationSlicing a solid to see what the interior looks likeEssential for multi-floor planning and engineering
Viewpoint translationConverting between first-person, top-down, and isometric viewsThe reason blueprints work
Scale invarianceUnderstanding that proportions are preserved under uniform scalingPixel art enlargement, terrain mapping
Symmetry detectionRecognizing reflection, rotation, and translation symmetriesHalves the work in any symmetric build
Path planningChoosing a route through a 3D environmentNavigation, redstone wiring, logistics

These primitives are not independent. A skilled builder uses them in combination — rotating a referenced structure mentally (mental rotation) while slicing it floor by floor (cross-section) and projecting to a top-down sketch (viewpoint translation).

Coordinate Systems and Orientation

Every spatial computing platform imposes a coordinate system. The skill of orienting oneself within that system is the entry point to all further work.

Right-handed vs left-handed

Most 3D systems use a right-handed coordinate system: X points east, Y points up, Z points south (or north — conventions vary). Confusion arises when tools disagree. Unity is left-handed; Unreal is left-handed; Minecraft is right-handed with Y as vertical; most CAD tools use Z vertical. The teaching move is to make the convention explicit and to have the learner physically gesture the axes before placing anything.

Cardinal directions

In-world navigation usually aligns the coordinate axes with cardinal directions. Minecraft's F3 debug overlay shows the player's facing direction. A learner who cannot translate "north" into "+Z axis" cannot follow blueprints. The first exercise in any spatial computing curriculum is a scavenger-hunt-style orientation task: "find a landmark 100 blocks north and 50 blocks east from here."

Chunk boundaries and quantization

Many spatial computing platforms quantize space into chunks or tiles for performance (Minecraft 16x16x256, VR scene graphs, Unreal streaming volumes). Understanding that the space is discrete at some level matters when designing builds that cross boundaries — a farm that straddles two chunks may behave differently when one chunk unloads.

Mental Rotation

Mental rotation is the ability to hold a 3D shape in mind and rotate it along any axis without losing track of its structure. Shepard and Metzler (1971) showed that rotation time scales linearly with rotation angle — the brain is doing a real simulation, not a lookup.

Teaching rotation

  • Start with 2D. Rotate letters in a plane. F, R, and G are asymmetric and reveal rotation errors immediately.
  • Add a third axis one at a time. First rotate around the vertical axis (yaw). Then pitch. Then roll. Combining all three is a later skill.
  • Use anchor features. Pick a distinctive feature of the object (the chimney of a house, the corner block of a machine) and track where it ends up. The rest of the object follows.
  • Gesture physically. Learners who use their hands to rotate an imaginary object learn faster than those who try to hold everything in their head.

Common failure mode

Learners often rotate the viewpoint instead of the object, or vice versa. The exercise "keep your body still and rotate the object" vs "keep the object still and walk around it" separates these two skills.

Cross-Section Visualization

Slicing a solid to see what is inside is a fundamental skill for multi-floor buildings, complex machinery, and redstone circuitry that spans vertical layers.

Techniques

  • Horizontal slice first. The floor plan is the most natural cross-section. Build the floor plan, then stack floors vertically.
  • Vertical slice to check structure. Once the floor plan is stable, slice vertically to check that load-bearing walls align across floors.
  • Transparent materials as debugging aid. Glass blocks, ghost blocks, or wireframe modes let a learner see through a solid to inspect the interior without disassembling.

Viewpoint Translation

A blueprint is a 2D projection of a 3D object. Translating between the two is the skill that makes technical drawing useful.

Projection types

ProjectionWhat it showsWhen to use
Plan view (top-down)Horizontal layoutFloor plans, site maps, routing
Elevation (front, side)Vertical face at one viewpointFacade design, height verification
IsometricPseudo-3D with all axes at equal anglesQuick 3D sketches without perspective distortion
First-personWhat the builder sees in-worldAesthetic checking, immersive design
OrbitalRotating around the objectPresentations, flythroughs

Skilled builders switch viewpoints constantly. A beginner who only builds from first-person will struggle with symmetry and alignment. A beginner who only draws plan views will struggle to anticipate what the build looks like from eye level.

Scale and Proportion

Scaling a reference design up or down requires understanding that not all features scale proportionally. Doors remain 1 or 2 blocks wide regardless of building scale. Windows have minimum sizes for function. Stairs have minimum rise/run for walkability. A learner who naively scales everything produces builds that look wrong even when the geometry is correct.

The rule of thumb

  • Gross structure scales. Walls, columns, roofs.
  • Functional features do not scale below their minimum. Doors, windows, stairs, ladders.
  • Ornamental features scale with gross structure. Trim, cornices, textures.

Symmetry Detection

Recognizing symmetry halves the work of designing or building any symmetric structure. A learner who builds a 4x reflectional-symmetric castle corner by corner does four times the work of one who builds one corner and uses a mirror operation.

Symmetry types

  • Reflectional — mirror across a plane. Common in buildings (left/right facade).
  • Rotational — turn around an axis. Common in towers, circular structures.
  • Translational — repeat along a direction. Common in walls, fences, corridor patterns.
  • Glide — translate then reflect. Common in ornamental borders.

Most in-world spatial computing platforms do not support explicit symmetry operations; the learner must plan the symmetry mentally and build accordingly. Tools like WorldEdit (Minecraft) and blueprint software (CAD) do support explicit symmetry.

When to Use This Skill

  • Teaching any spatial computing task to a learner who struggles with 3D visualization
  • Diagnosing why a build "looks wrong" despite following directions
  • Designing exercises that scaffold spatial reasoning through progressive challenge
  • Translating between blueprint representation and in-world construction

When NOT to Use This Skill

  • Pure 2D design work (use a 2D design skill instead)
  • Tasks where the spatial structure is trivial (a single block, a flat floor)
  • Debugging redstone timing or circuit logic (use redstone/logic skills)

Common Mistakes

MistakeWhy it failsFix
Skipping coordinate orientationLearner places blocks at randomRequire the F3 overlay / coordinate display
Rotating viewpoint instead of objectLearner gets dizzy, loses trackSeparate the two skills explicitly
Not sketching before buildingWasted blocks, torn-down mistakesRequire paper sketch first
Scaling all features uniformlyDoors become 4-wide, look wrongTeach functional minimums
Ignoring symmetry4x work on symmetric buildsAsk "can you mirror this?"
Single viewpoint onlyMisses alignment errors across viewsRequire two viewpoints before declaring done

Cross-References

  • sutherland agent: Coordinate frames, display transformations, and the geometry of early CG
  • engelbart agent: Navigation, viewpoint, and embodied interaction
  • bret-victor agent: Direct manipulation and dynamic representations of spatial data
  • papert-sp agent: Constructionist scaffolding for spatial reasoning development
  • immersive-environment-design skill: VR/AR environment authoring that depends on these primitives
  • world-building-block-paradigms skill: Voxel construction that builds on these cognitive primitives

References

  • Shepard, R. N., & Metzler, J. (1971). "Mental rotation of three-dimensional objects." Science, 171(3972), 701-703.
  • Sutherland, I. E. (1963). Sketchpad: A Man-Machine Graphical Communication System. MIT Lincoln Laboratory TR-296.
  • Papert, S. (1980). Mindstorms: Children, Computers, and Powerful Ideas. Basic Books.
  • Minecraft Wiki. F3 debug overlay and coordinate system. (Accessed 2026.)
  • Newcombe, N. S., & Shipley, T. F. (2015). "Thinking about spatial thinking." In Studying visual and spatial reasoning for design creativity. Springer.