#185, #182: doc: complete spec of cortex scripts