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.
git clone https://github.com/Tibsfox/gsd-skill-creator
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"
examples/skills/spatial-computing/spatial-reasoning-fundamentals/SKILL.mdSpatial 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
| Primitive | What it is | Why it matters |
|---|---|---|
| Coordinate framing | Anchoring position to an origin plus three axes | Without a frame there is no "here" and no "there" |
| Mental rotation | Rotating an object in imagination to compare with a target | Every build-from-reference task requires it |
| Cross-section visualization | Slicing a solid to see what the interior looks like | Essential for multi-floor planning and engineering |
| Viewpoint translation | Converting between first-person, top-down, and isometric views | The reason blueprints work |
| Scale invariance | Understanding that proportions are preserved under uniform scaling | Pixel art enlargement, terrain mapping |
| Symmetry detection | Recognizing reflection, rotation, and translation symmetries | Halves the work in any symmetric build |
| Path planning | Choosing a route through a 3D environment | Navigation, 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
| Projection | What it shows | When to use |
|---|---|---|
| Plan view (top-down) | Horizontal layout | Floor plans, site maps, routing |
| Elevation (front, side) | Vertical face at one viewpoint | Facade design, height verification |
| Isometric | Pseudo-3D with all axes at equal angles | Quick 3D sketches without perspective distortion |
| First-person | What the builder sees in-world | Aesthetic checking, immersive design |
| Orbital | Rotating around the object | Presentations, 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
| Mistake | Why it fails | Fix |
|---|---|---|
| Skipping coordinate orientation | Learner places blocks at random | Require the F3 overlay / coordinate display |
| Rotating viewpoint instead of object | Learner gets dizzy, loses track | Separate the two skills explicitly |
| Not sketching before building | Wasted blocks, torn-down mistakes | Require paper sketch first |
| Scaling all features uniformly | Doors become 4-wide, look wrong | Teach functional minimums |
| Ignoring symmetry | 4x work on symmetric builds | Ask "can you mirror this?" |
| Single viewpoint only | Misses alignment errors across views | Require 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.