It'd be great if required variables could be paired with a description, that way a task author could explain what the var is for, or how you might want to acquire the value.
E.g.:
required:
env:
- name: REPO_NAME
description: "The name of the repo needed for blah blah."