You could make writing YAML Specs much easier by providing a JSON schema that could be used to validate the document. I currently use VS Code for editing the YAML and the YAML Language Support extension would allow this. Publishing the schema to the JSON Schema Store would provide a really nice experience to users. It seems like this would be a big improvement for minimal input.