When explaining the architecture and the evaluate request sent by Watson Assistant Solutions to the skill we need to include the JSON structure sent and the JSON Structure that is required to be returned. A skill developer will never be able to create a skill without this. The APIs need to be documented in the Swagger.
https://watson-personal-assistant.github.io/developer/understand-service/how-it-works/
JSON for 1, 2, 3, 4 and 5.
Here are examples: Slide 18
https://ibm.box.com/s/pm48vi3w55g48483joljoxm1hfq7bgrq