A linter can catch some obvious errors: https://github.com/rhysd/actionlint. But yes, I agree, it's not a fun debugging experience.

act would also be helpful here in terms of debugging and development of Actions workflows.