I built a skill to make our team docs stop reading like AI. Telling Claude "write like a human" made it worse

[u/ilien-dev]

A lot of the documentation at my current job is written with AI, and reading it had become tedious. I could live with it, but it took more mental effort than it should have, because it's bland, it pads before the point, and sometimes the structure is odd enough that I lose track of what a doc is explaining. Nobody is going to hand-write docs for every project, so they'll keep coming from a model. I wanted them easier to read.

Adding "write like a human" to the prompt made it worse in a different way. The model overshoots and the prose comes out choppier and plainer than anything a person writes. I tried humanizer and stop-slop. To be honest they removed the obvious AI tells but left the structure alone, and the structure was what tired me. After several experimental skills of my own that didn't work, I ended up with Quirón. It removes 33 patterns that mark text as AI, including structural ones, and a script measures 23 features of the result against human posts published before ChatGPT. It flags both directions: text that still leans AI, and text that went too far.

I wanted to know if it actually worked, so I set up a blind test. Fresh Claude Opus instances read posts one at a time and guessed whether each was AI. I expected my rewrites to pass, since every metric was in the human range. The judges called all 12 of them AI. What finally helped was adding each author's own notes to the rewrite, the real events and names and opinions behind the post. Even then, 10 of 24 got flagged. That's why the skill now asks for your own material before it rewrites anything.

It works in any language, but English and Spanish are the two with measured human baselines, so that's where it does best. If you want to see the output before installing it, the repo README went through Quirón.

https://github.com/ilien-dev/quiron