I created this VS Code extension that shows comments when you mouse over package scripts. I would appreciate it if you could try it out and provide feedback. Thank you.
https://marketplace.visualstudio.com/items?itemName=yeongmin.package-scripts-hover