explaingit

seochecks-ai/slopless

Analysis updated 2026-06-24

255TypeScriptAudience · writerComplexity · 2/5Setup · easy

TLDR

CLI built on textlint that flags AI-style prose slop in Markdown using 50+ deterministic rules and outputs JSON for agent feedback loops.

Mindmap

mindmap
  root((slopless))
    Inputs
      Markdown files
      Globs
      Stdin pipe
    Outputs
      JSON findings
      Exit codes
      Skill files
    Use Cases
      Codex skill
      Claude Code skill
      CI gate
    Tech Stack
      TypeScript
      textlint
      Node
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Lint Markdown docs for vague or AI-style prose in CI

USE CASE 2

Install Slopless as a Claude Code or Codex skill for a write-lint-rewrite loop

USE CASE 3

Pipe drafts through slopless via stdin and gate publishing on exit code 0

What is it built with?

TypeScriptNode.jstextlint

How does it compare?

seochecks-ai/sloplesstexsellix/polymarket-trading-botgermondai/trawl
Stars255244218
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencewriterdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install as a Node dev dependency, agent loop works best after running the skill installer for Codex or Claude Code.

In plain English

Slopless is a command-line tool for catching what its authors call 'prose slop' in English Markdown documents. It is built on top of textlint and ships more than 50 deterministic rules that look for common patterns of bland, vague, or AI-generated writing. The key word is deterministic: it does not call a language model to make its judgments, it just applies fixed rules and reports findings as structured JSON. The intended workflow is to plug it into an AI writing agent. You install Slopless as a dev dependency in your project, then run a command that installs a 'skill' file for either Codex or Claude Code. Once installed, you tell the writing agent to use the Slopless skill and let it loop: write, run Slopless, read the JSON findings, rewrite, rerun, until the output is clean. The README describes this as the main intended usage pattern. You can also run it directly from the command line against a file path, a glob like docs/**/*.md, or piped stdin. Exit code 0 means the file is clean, 1 means there were findings, and 2 means the command itself failed. The output is always JSON, which the README suggests saving under a .slopless/findings directory with a timestamped filename for later review. For cases where a flagged sentence is intentional, the README shows how to wrap it with textlint-disable and textlint-enable HTML comments to skip specific rules in specific places. The README links out to a wiki for deeper material, including a philosophy page, a comparison against tools like proselint, write-good, alex, and vale, a full rule inventory across seven rule families, and a behavior reference for CLI flags, exit codes, and JSON shape. Slopless is developed by seochecks.ai and the stated goal is to keep written content specific, useful, and recognizably human.

Copy-paste prompts

Prompt 1
Show me how to add slopless as a dev dependency and wire its Claude Code skill
Prompt 2
Write a CI step that runs slopless on docs/**/*.md and fails on exit code 1
Prompt 3
Explain how to use textlint-disable comments around a deliberately flagged sentence
Prompt 4
Compare slopless rule families to proselint and vale for catching AI slop

Frequently asked questions

What is slopless?

CLI built on textlint that flags AI-style prose slop in Markdown using 50+ deterministic rules and outputs JSON for agent feedback loops.

What language is slopless written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, textlint.

How hard is slopless to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is slopless for?

Mainly writer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.