What about --help? Isn't that a perfect parallel to discovery of available tools in an MCP server?

Yup. I’ve been using CLIs with skills that define some common workflows I use and then just tell Claude to use —help for understanding how to use it. Works perfectly and I end up writing the documentation in a way that I would for any other developer.