# no-ai-slop-writing-rules

[![skills.sh](https://skills.sh/b/realrossmanngroup/no_ai_slop_writing_rules)](https://skills.sh/realrossmanngroup/no_ai_slop_writing_rules)

> # 👋 Hi, you were probably sent here.
>
> ## If someone handed you a link to this repo, it is because you sent them AI-generated shit so obviously AI-generated that they stopped reading partway through and went looking for a polite way to say "run it through a human first."
>
> Pasting raw Gemini or ChatGPT output with zero editing, or running a project with no anti-slop rules at all, is the 2026 equivalent of handing out a business card with an `@aol.com` email on it. The tool is fine. Shipping its first draft with your name on it is the part people notice.
>
> Nobody is mad that you used a model. Everybody can tell, because the model has tics and you left every one of them in.
>
> The dead giveaway is the "It's not X. It's Y." construction, and its cousin "It's not just X, it's Y with Z." *This isn't a price increase. It's a betrayal of trust.* *This isn't just a phone. It's a statement.* The model loves it because it sounds profound and commits to nothing. Real people do not talk like this. They say what the thing is.
>
> Then there is the dramatic noun-phrase heading. The model writes **"The Pricing Trap"** when the honest heading is "how to avoid scam pricing." It writes **"The Hidden Cost of Convenience"** instead of "subscriptions add up." A heading is supposed to tell you what is in the section, not tease it like a movie poster.
>
> And the rest of the kit: "Let's dive in." "Here's the thing." "But here's the kicker." "In a world where..." A 🚀 emoji in front of a bullet. Every list built in threes because three sounds complete. The fake-punchy one-line paragraph.
>
> For drama.
>
> Read your own output before you send it. That is the whole ask.
>
> The rules below are what "read it first" looks like written down. Steal them.

---

A portable Agent Skills package for writing in Louis Rossmann's voice without AI slop. It is general-purpose: essays, scripts, posts, documentation, emails, anything made of sentences. It is not tied to any wiki, CMS, or publishing system.

Compatible with Claude Code, OpenAI Codex, Cursor, Windsurf, and agents that follow the [Agent Skills specification](https://agentskills.io/specification.md).

## What it does

It gives an agent two things. First, a hard rule set that strips the patterns marking machine-generated text: emdashes, intensifiers, filler phrases, hollow statements, fabricated facts, AI transition words, dramatic headings, and the rest. Second, a data-driven voice profile built from corpus analysis of 513,683 words of Rossmann's writing: testable-number density, high sentence-length variance, claim-then-proof paragraph structure, contractions, the ampersand habit, and contempt shown through precision rather than adjectives.

## How to use it

Install the skills into an agent project, drop this folder next to a project, or point Claude Code at it. When you ask an agent to write or edit prose, it reads the two skills, writes against the rules, then self-checks the output against the banned-words reference before returning it.

## Installation

### CLI install

```bash
npx skills add realrossmanngroup/no_ai_slop_writing_rules
```

Skills install to `.agents/skills/` in your project.

### Claude Code plugin

```bash
/plugin marketplace add realrossmanngroup/no_ai_slop_writing_rules
/plugin install no-ai-slop-writing-rules
```

### Clone and copy

```bash
git clone https://github.com/realrossmanngroup/no_ai_slop_writing_rules.git
cp -r no_ai_slop_writing_rules/skills/* your-project/.agents/skills/
```

You can also read the files yourself as a style guide. Every file here obeys its own rules, so they double as worked examples.

## What each file does

| File | Contents |
|---|---|
| `CLAUDE.md` | Claude Code entrypoint. States the purpose, summarizes the voice, sets the operating rules, and lists all 24 anti-slop rules. |
| `AGENTS.md` | Cross-agent repository instructions and publishing format notes. |
| `.claude-plugin/marketplace.json` | Claude Code plugin marketplace manifest. |
| `skills/no-ai-slop/SKILL.md` | The anti-slop rules as actionable guidance, with WRONG/RIGHT worked examples and a self-check pass. |
| `skills/no-ai-slop/references/ai-writing-detection.md` | The full banned-words reference: verbs, adjectives, transitions, phrases, intensifiers, heading anti-patterns, academic tells, hedging markers, and structural and statistical patterns. |
| `skills/rossmann-voice/SKILL.md` | The voice profile: sentence-level rules, paragraph structure, drift prevention, the Claim-Mechanism-Reality argument pattern, a vocabulary guide, a DO/DON'T table, and the statistical fingerprint. |
| `.claude/skills/` | Claude Code project-local mirror of the published skills. |

## Scope

The examples in the voice skill are repair-themed because that is what the source corpus covers. The traits themselves are structural, so the voice applies to any subject. Write about anything in it; the rules hold.