1 files changed, 37 insertions, 0 deletions
diff --git a/data/help/walk.yaml b/data/help/walk.yaml
new file mode 100644
index 0000000..6c34ecd
--- /dev/null
+++ b/data/help/walk.yaml
@@ -0,0 +1,37 @@
+name: "walk"
+category: "Exploration"
+description: |
+  Move multiple rooms in sequence over successive ticks.
+
+  Usage: walk <directions>
+         walk <room-number>
+
+  Direction mode:
+    Provide a string of direction characters (n, s, e, w, u, d).
+    Each character queues one movement step per game tick.
+
+    Examples:
+      walk nnewn       Walk north, north, east, west, north (5 ticks)
+      walk 2e3nwwn     Walk 2 east, 3 north, west, west, north (8 ticks)
+
+    Shorthand numbers multiply the following direction, so 3n means
+    three north moves.
+
+  Room number mode:
+    Provide a numeric room ID (as seen in look output or on the map).
+    The game calculates the shortest path of exits from your current
+    room to the target room and walks it automatically.
+
+    Example:
+      walk 15          Walk to room #15 via shortest path
+
+  Limits:
+    Your maximum walk length is equal to your agility level. If you
+    try to walk farther, the command is rejected.
+
+    If you hit a blocked or missing exit mid-walk, the entire
+    sequence stops immediately.
+
+  While walking, you appear as "walking somewhere with a purpose!"
+  when other players look at the room. The walk action interrupts
+  any other active action you were performing.