AI writing rules Install

Stop Claude writing like an AI

It checks every file Claude writes and flags AI tells by line number. Claude fixes them before moving on.

Install the plugin Browse the 65 rules

Free and MIT licensed. Needs Python 3 for the checker.

After Claude writes guide.md5 issues found
negative parallelism: delete the negation
  L3: isn't just a tool, it's
AI vocabulary: use the plainest word
  L3: paradigm; L8: underscores
rule of three: use one, two, or four
  L3: robust, seamless, and scalable
Title Case heading: sentence case
  L1: # The Complete Guide To Modern Deployment
Run inside Claude Code
/plugin marketplace add Abdulkader-Safi/AI-Writing-Rules
/plugin install ai-writing-rules@ai-writing-rules

Restart Claude Code after installing. The rules load on the next session.

Two commands for when you want a full rewrite

Type them in Claude Code. Each one reads the plugin's rules first, then works on your files.

/deslop

Audits a file, rewrites it and re-runs the checker until it comes back clean. Facts, numbers, links and code stay exactly as they were. With no argument it works on the last thing Claude wrote.

/ai-writing-rules:deslop docs/guide.md

/copywrite

Checks a website's pages against the 36 copy rules and reports each problem with file:line and a rewrite. On a new project it asks for your facts first, then writes the pages and marks anything missing as a TODO.

Legal risks go to the top of the report:

  • Testimonials that look invented or edited
  • Fake urgency and resetting timers
  • Billing terms that aren't stated
/ai-writing-rules:copywrite
/ai-writing-rules:copywrite https://your-site.com
20

patterns checked after every write: 17 by pattern match and 3 by sentence statistics.

Quoting bad examples on purpose?

Add this line anywhere in the file and the checker skips it.

<!-- slop-check: off -->

It runs on its own once installed

Two hooks do the daily work. You only type a command when you want a full rewrite or a copy review.

Rules load at session start

A hook adds the hard rules to every session: no em dashes, straight quotes, sentence case headings and the words to avoid.

270words of context

Every write gets checked

After each write to a prose file, the checker scans it and sends Claude the line numbers to fix before it moves on.

.md.mdx .markdown .txt .rst

Detail loads on demand

The anti-ai-writing skill points at one research file per pattern. Claude opens the one it needs.

1file of 29 at a time

Code is left alone

Fenced code blocks and inline code are stripped before scanning, so code samples never trigger a warning.

0code blocks scanned

One pattern on its own proves nothing. Three or four in the same piece is the signal. Every rule below links to its research: a bad example, the rewrite and the fix.

29 patterns that give AI writing away

Grouped the way the research files are. Open a group to see each pattern and its fix.

Vocabulary 3

  1. 01AI vocabularySwap delve, seamless and robust for the plain word.
  2. 02Corporate verb inflationUse, not utilize. Help, not facilitate.
  3. 27Narrow vocabulary rangePick the exact word instead of the same safe few.

Sentence patterns 6

  1. 03Dodging "is" and "are"Write "is", not "serves as" or "stands as".
  2. 04Negative parallelismDrop the "not just X" half and keep the claim.
  3. 05Rule of three on autopilotCount the items. If it is always three, change the count.
  4. 07Trailing "-ing" commentaryCut tails like ", highlighting its importance".
  5. 21Elegant variationCall one thing by one name.
  6. 22Hedging everythingMake the claim or drop it.

Substance 6

  1. 06Puffed-up significanceSay what happened, not why it matters to history.
  2. 08Vague attributionName the source or cut "experts say".
  3. 09Promotional languageDescribe what it does. Skip the brochure tone.
  4. 10Empty-opener clichesOpen with the point, not "In today's world".
  5. 11Pseudo-wisdom fillerCut lines that sound wise and carry no fact.
  6. 25The deletion testDelete each sentence. If nothing is lost, it goes.

Rhythm and punctuation 5

  1. 12Transition-word stackingStop opening paragraphs with "Moreover".
  2. 13Uniform sentence lengthMix three-word and forty-word sentences.
  3. 14Thin punctuationUse colons, full stops and brackets, not only commas.
  4. 15Em dash overuseUse none at all.
  5. 16Curly quotesStraight quotes and three plain dots.

Structure and formatting 5

  1. 17Heading tellsSentence case, and no skipped heading levels.
  2. 18Excessive boldBold one thing per screen at most.
  3. 19Forced tablesUse a table only for data with rows and columns.
  4. 20Outline-shaped endingsEnd at the last real sentence.
  5. 28Treating the title as a thingDon't open by defining your own title.

Leftover machinery 4

  1. 23Assistant scaffoldingDelete "Certainly!" and "I hope this helps".
  2. 24Model artifactsStrip leaked markup and citation tokens.
  3. 26Canned summariesCommit messages say what changed and why.
  4. 29Register mismatchA one-line question gets a one-line answer.

36 rules for website copy

/copywrite checks your pages against these, in the order you would write a page. Each rule carries the strength of its evidence.

Questions before you install

Will it flag my code?

No. The checker only reads prose files (.md, .mdx, .markdown, .txt and .rst) and strips code blocks and inline code before scanning.

How much context does it use?

The session rules are about 270 words. The 29 research files load only when Claude opens one for a specific pattern.

A file quotes bad examples on purpose. Can I skip it?

Yes. Add <!-- slop-check: off --> anywhere in the file and the checker ignores it.

What happens without Python?

The checker exits quietly and the session rules still load. Python 3 ships with macOS and most Linux distributions.

Can it tell if someone else used AI?

No. Every pattern has an innocent explanation on its own. These are rules for writing better, not a verdict on who wrote something.

Install it in two commands

Run them inside Claude Code, then restart. The rules load on the next session.

Free, MIT licence
/plugin marketplace add Abdulkader-Safi/AI-Writing-Rules
/plugin install ai-writing-rules@ai-writing-rules
Read the source on GitHub