I suppose our action.yml could be used to generate the docs' "Inputs and Outputs" page. But I think some metadata (like minimum required version and required token permissions) would not be suitable in the conventional syntax for action.yml.

It is worth a try since it would only be a modification of docs/badge_hook.py.