spiral-walk

name	spiral-walk
description	Walks an inward spiral toward the center, via a sequence of root waypoints with a shrinking radius. Use when a command mentions spiral walk, walk in a spiral, spiral inward, or wind inward in a coil.
category	locomotion
disable-model-invocation	true
subskills	["walk","turn-and-face"]

spiral-walk

A coiling path that spirals from the outside inward toward the center.

Composes: walk + turn-and-face

How

• Use a sequence with loop:false. Frame root is ABSOLUTE; compute the travel axis from state.position+state.faceDeg (0=+Z, 90=+X). The example assumes origin facing +Z.
• Waypoints orbit with a steadily shrinking radius toward the center; faceDeg stays tangent.
• durationMs ~5500.

Example

• "walk in a spiral" -> {"durationMs":5500,"say":"Spiraling inward.","sequence":{"loop":false,"frames":[{"t":0,"root":{"x":2.5,"z":0,"faceDeg":-90}},{"t":0.3,"root":{"x":0,"z":2,"faceDeg":180}},{"t":0.55,"root":{"x":-1.5,"z":0,"faceDeg":90}},{"t":0.8,"root":{"x":0,"z":-1,"faceDeg":0}},{"t":1,"root":{"x":0.5,"z":0,"faceDeg":-90}}]}}

Limits & posture

Keep ≥1 foot grounded except at a jump's airborne apex; stay inside human joint ranges and keep weight over the support — see balance-and-posture.