sherlock
80 lines
5.0 KiB
Markdown
80 lines
5.0 KiB
Markdown
# 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.
|