Guide
How to read SKN
A top-down flow of moves. Each branch is one action: turn or step, then stance, technique, and an optional note.
The idea
Spatial Kata Notation (SKN) is a plain-text tree. You read from top to bottom. The header names the kata and starting orientation. Each + branch is one beat of the kata.
Header
==================================================================================================== KATA: Pinan Nidan (Shito-Ryu) START: [0,0] Face N (^) | Musubi-dachi → Reigi (Bow) → Yoi (Heisoku-dachi) ====================================================================================================
- KATA: name and style/school reading
- START: floor origin
[0,0], initial facing, and opening etiquette
One move
+-- [STEP → N] -------------- (Face: N) | ├─ Stance : [R] Z-D | ├─ Action : Right Age-uke (J) | └─ : Rise under attack angle
- Movement:
[STEP → N],[MAWATTE → W], or[SLIDE → E] - Face: compass facing after the move (not floor coordinates)
- Stance: lead side
[L]/[R]plus stance code - Action: technique name and height (
J/C/G) - Optional line:
Note,Key,Target,Kiai, orBunkai
Multi-beat moves
Some transitions are two actions under one turn or step. Nest them asBeat 1 / Beat 2 with their own Action lines:
+-- [MAWATTE → E] ----------- (Face: E) | ├─ Beat 1 : [R] Z-D | │ └─ Action : Right Gedan-barai (G) | ├─ Beat 2 : Pull back into [R] N-D | │ └─ Action : Right Tetsui Otoshi-uchi / Otoshi-uke (C) | └─ : Distinct two-part transition
Refinements from the first draft
The tree format stays. A few labels are tightened so humans (and future tools) read them the same way:
(Position: W)became(Face: W): it was always facing, not a grid cell[TURN 90° W]became[MAWATTE → W]: destination facing first; depth/degrees only when useful (· deep,· 90°)- Freeform tags collapsed to a small set: Note, Key, Target, Kiai, Bunkai
Compass
Relative to the starting line of the kata: N is the opening forward direction. S is behind you at yoi. Diagonals use NE NW SE SW. Facing glyphs:^ N, v S, > E, < W.
Floor coordinates like [0,0] are optional markers forembusen discussion. Most sheets only need Face + STEP/MAWATTE.
Next: the full notation key, the completePinan Nidan example, or thepractice generator.