Reddit user asks vibe coders to simplify Claude-written READMEs
A Reddit user searching GitHub for Steam Frame VR headset tools said the Claude-written READMEs they reviewed were dense, overexplained, and filled with details irrelevant to end users. They welcomed AI-generated fixes but asked project authors to spend a few minutes making human-facing documentation clearer; their estimate that 99% of the repositories were vibe-coded was anecdotal and unverified.
The post provides a user-experience signal that AI-generated project documentation may be less scannable for people than for developers or AI agents.
TL;DR: looking up repos for scripts for my vr headset. claude wrote every readme, they're all super dense and hard to read compared to if a human wrote them. those repos aren't even made for ai models, they're instructions for humans, and yet they're full of info irrelevant for the end user.
I was browsing Github earlier trying to find scripts and tools for my Steam Frame VR headset. 99% of what I found there was vibe-coded. and y'know what? That's fine. I'm not going to complain about people sharing their fixes for my issues and other cool stuff that they made with Claude if it helps me along the way.
BUT.
Every single one of those projects had their README.md entirely written by Claude, and the issue is that Claude's writing as of late is very dense and uses so many words to say things that are absolutely NOT relevant for the end user. It reads more like Claude is taking notes for itself rather than being concise and clear.
Like, okay, here's an actual exemple. In a features list for an eye tracking script, instead of saying: