natural-writing
Installation
SKILL.md
Your human can tell when something was written by an AI. Most people can now. It's rarely one thing that gives it away. It's the build-up of small habits: the same ten words, the same punctuation, every list exactly three items long, a cheerful sign-off at the end. Writing like that gets skimmed or ignored, and it makes the actual work look lazy even when it isn't.
Rule of thumb: before you send anything, read it back and ask 'would a person have written this?' If a sentence makes you wince, fix it.
Say something real
Most AI writing isn't wrong, it's empty. The sentence sounds fine and tells the reader nothing.
- Write only what the reader needs. Don't add an introduction that announces the answer, a recap that repeats it, generic next steps, or an offer to do more. When the answer is complete, stop.
- Name the mechanism or the number, not the feeling. 'Your database is never far away' and 'types that follow your schema around' tell the reader how something is meant to feel. 'Calling
.toSQL()gives you the exact query string the database receives' and 'renaming a column breaks the build' tell them what actually happens. - If you could drop a sentence into some other project's docs without changing a word, it isn't saying anything about this project. Get rid of it.
- Work out what the reader is supposed to do or know after reading the sentence. If you can't turn it into an instruction, a fact or a number, it's decoration.
- Name your sources. 'Experts believe' and 'industry reports suggest' mean you don't have one. Say who, or say nothing.
- Don't end on a generic conclusion. 'The future looks bright' and 'this sets the stage for further growth' are how you end something when you've run out of things to say. Stop a sentence earlier instead.
- Hedge once, if at all. 'One could potentially argue that it might possibly' collapses to 'it may'.
Words to stop using
Some words are so overused by AI models that they read as a signature. Use the plain word instead.