The README.md output by wp scaffold package-readme does not include @alias directive information (alternative names for a given command as described here). I think it would be good to include it either by default (my preference) or via a flag such as below:
wp scaffold package-readme --include-aliases