The PackageDev package generates popups with a description of the key for settings files. For example:

Because we're basically doing the same for schema files (for .sublime-settings) manually, I think it would be worthwhile to look into how to automate writing a skeleton schema file for a given .sublime-settings file.
I've skimmed through the code and I think this is the relevant part:
https://github.com/SublimeText/PackageDev/blob/ac1fb9803319ab518c664110f2f0f82a33f1fe73/plugins_/settings/known_settings.py#L254-L312
The PackageDev package generates popups with a description of the key for settings files. For example:
Because we're basically doing the same for schema files (for .sublime-settings) manually, I think it would be worthwhile to look into how to automate writing a skeleton schema file for a given .sublime-settings file.
I've skimmed through the code and I think this is the relevant part:
https://github.com/SublimeText/PackageDev/blob/ac1fb9803319ab518c664110f2f0f82a33f1fe73/plugins_/settings/known_settings.py#L254-L312