Claude, write a skill to create design docs as per this blog post /s

In all seriousness a big chunk of my work is reviewing docs and 100% of the design docs I read these days are generated and there is a lot of slop. I have to parse them with AI to make sense of them, contributing to the problem. I wish people would follow a sensible set of rules like this one.

Did anyone have any solution to this dread? Or cracked the code on how to write docs that have other agents as their primary audience?