Repolode
Submit
ItsssssJack

ItsssssJack/SlopMonster

A Python checker that flags common AI writing patterns in English text and scores it out of 5, plus an AI-assisted editing workflow.

View on GitHub
Stars
1,131
Forks
112
Open issues
4
Last commit
24 days ago

What is it?

SlopMonster checks English writing for common patterns associated with AI-generated text. It is aimed at drafts such as READMEs, landing pages, emails and scripts. The Python checker runs on the standard library with no API key or packages to install, and reports matches across five categories: vocabulary, sentence patterns, punctuation, three-item lists and unsupported numeric claims. Each category with a match costs one point, giving a score out of 5.

Beyond the checker, the project provides a prompt-based editing workflow. An AI agent reviews the draft for its intended reader and revises it, and an optional script asks a CLI tool from a different model family to make a second editing pass. Markdown and HTML inputs are handled by skipping code blocks or stripping tags before scoring.

The project notes that a 5/5 score only means no scored patterns were found. Readers still need to judge whether the text is clear, supports its claims and serves its audience.

Key features

  • 01Scores English text out of 5 across five categories of AI writing patterns.
  • 02Runs with Python 3's standard library and needs no API key.
  • 03Handles Markdown and HTML inputs, skipping code blocks and tags.
  • 04Provides an optional second editing pass through a different model's CLI.
  • 05Includes a GitHub Actions workflow example for running the check in CI.

Use cases

  • Checking a README or landing page draft before publishing.
  • Reviewing marketing emails or announcements for generic AI phrasing.
  • Adding a lint-style check to a repository's CI pipeline for documentation.
  • Guiding an AI agent through a structured editing pass on a draft.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/ItsssssJack/SlopMonster
  2. 2

    Change into the project folder

    cd SlopMonster
  3. 3

    Check a short draft with the checker

    python3 tools/deslop.py --text "It's not just a tool, it's a game-changing journey."
  4. 4

    Check a Markdown file

    python3 tools/deslop.py README.md

Things to know

  • The checker only recognizes English writing patterns and has no language detection, so text in other languages can wrongly score 5/5.
  • A passing score does not establish writing quality, verify facts, or confirm the text suits its audience.
  • The AI editing workflow needs a supported AI command-line tool installed and authenticated, plus access to a second model family.

Topics

#ai-writing#linter#writing#python#copywriting#editing#llm#cli

FAQ

What is SlopMonster?
A Python checker that flags common AI writing patterns in English text and scores it out of 5, plus an AI-assisted editing workflow. SlopMonster checks English writing for common patterns associated with AI-generated text. It is aimed at drafts such as READMEs, landing pages, emails and scripts. The Python checker runs on the standard library with no API key or packages to install, and reports matches across five categories: vocabulary, sentence patterns, punctuation, three-item lists and unsupported numeric claims. Each category with a match costs one point, giving a score out of 5.
Is SlopMonster free to use? What license does it have?
SlopMonster is open source under the MIT license. Check the license terms before using it in commercial products.
Is SlopMonster still maintained?
Actively maintained. The last commit to SlopMonster was on Sep 26, 2026.
What can I use SlopMonster for?
Checking a README or landing page draft before publishing. Reviewing marketing emails or announcements for generic AI phrasing. Adding a lint-style check to a repository's CI pipeline for documentation. Guiding an AI agent through a structured editing pass on a draft.
How do I install SlopMonster?
Clone the repository: git clone https://github.com/ItsssssJack/SlopMonster Change into the project folder: cd SlopMonster Check a short draft with the checker: python3 tools/deslop.py --text "It's not just a tool, it's a game-changing journey." Check a Markdown file: python3 tools/deslop.py README.md
Where can I get SlopMonster?
The source code and installation instructions are on GitHub: https://github.com/ItsssssJack/SlopMonster

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects