Repository avatar
AI Tools
v0.7.0
active

dislop

io.github.dislop-ai/dislop

Linter for AI Slop in docs, web UI, and slides — Official Cloud MCP.

Documentation

dislop — Catch AI slop before you send it

简体中文 · Try it at dislop.com · npm · PyPI · Awesome Anti-Slop · Roadmap · X (@dislop_ai) · Apache-2.0

dislop is a dedicated Linter for AI Slop. It combines vetted community anti-slop rules, corpus findings, and 87 curated tools so you (and your agent) can catch and fix AI-sounding text and template layouts before sharing docs, web pages, or slides. It ships in three clean layers: a pure-Markdown Skill (genre reference cards with zero scripts), an open-source local CLI & editor plugins (zero-dependency offline checking across docs, web UI, Word, and PowerPoint), and Official Cloud MCP & Web Workbench (https://dislop.com/mcp, zero-setup genre-aware multi-model review and layout-preserving Office handling).

Here is a short launch note straight from a model:

Certainly! Here is the launch note. It's worth noting that exports are a game-changer, finishing in up to 12 minutes for workspaces above 500,000 rows.

dislop check launch-note.md flags three things:

[ERROR]   launch-note.md:1:1   chatbot-artifact           "Certainly! Here is"
[WARNING] launch-note.md:1:37  en-throat-clearing-opener  "It's worth noting that"
[INFO]    launch-note.md:1:75  en-cliche-lexicon          "game-changer"

If you rewrite it into a second-order AI slogan (This isn't just an upgrade — it's a new standard.), running dislop check catches that too. Clean it up into plain prose and dislop check exits 0.

dislop checking a launch note across 3 states: flagging chatbot artifact and filler, catching a second-order slogan, and passing with exit 0

That's it. It inspects Markdown, plain text, HTML/CSS/JSX, Word (.docx), and PowerPoint (.pptx). The open-source CLI and local plugins run completely offline with zero uploads, bundling all 7 built-in packs (42 rules), 5-axis rhythm telemetry, extended pattern probes (--patterns), and the 14.6 KB Pocket ML scorer (--ml). Zero offline hits only means no known surface or structural pattern matched—it does not prove deep content quality. Sign in at dislop.com or connect Official Cloud MCP (https://dislop.com/mcp) for multi-model genre-aware review (dislop_review returns structured issues and edit guidance for your local agent to revise in project context).

Quick start

Node.js 20+ (published on npm, zero dependencies, all 7 packs bundled offline)

# Check the current folder (exits 1 on core AI artifact errors; prints cliché warnings)
npx --yes dislop check .

# Auto-route domain pack and enable 5-axis telemetry, 14.6 KB Pocket ML, and extended pattern probes
npx --yes dislop check draft.md --pack auto --profile --ml --patterns

# Extract a deterministic personal voice profile offline or inspect a rule's examples
npx --yes dislop voice my-notes.md
npx --yes dislop explain negation-pivot-frame

# Check only lines changed against main and emit GitHub PR annotations
npx --yes dislop check --changed origin/main --format github

Python 3.10+ (published on PyPI, zero dependencies)

# Run directly via uvx (zero install) or install via pip
uvx dislop check quarterly-review.pptx
pip install dislop && dislop check .

dislop CLI offline check failing with exit code 1 on draft and passing with exit code 0 after cleanup

AI artifacts vs. style warnings

Auto-rewriters often trade one AI cliché for another or flatten your voice into a generic template. Flat banned-word lists also cause false alarms on ordinary nouns (Delve debugger, wool tapestry).

dislop splits its 42 rules across 7 bundled packs into two layers:

  1. AI delivery artifacts (packs/core/, severity: error, always on): Clear leftovers from AI generation—stray chatbot greetings (Certainly! Here is..., [oaicite:1]), unfilled [insert ...] / {{var}} / [TBD] placeholders, raw Markdown asterisks pasted unrendered into .docx/.pptx, and dead <a href="#"> placeholder buttons.
  2. Built-in scenario & vertical packs (warning / info, advisory by default, 0 network downloads): business-brief, engineering-spec (PR diff parrots, shallow root causes, unowned action items), regulated-comms (unsubstantiated superlatives, unanchored "10x faster" multipliers), literary-essay, deck-and-ui, and executive-deck (process-only slide titles, 4+ consecutive identical slide skeletons). Each rule includes a check question, before / overcorrected / after examples, and automated hit/clean tests.

What it reads

Both the Node.js CLI (bin/dislop.mjs) and the Python CLI (src/dislop/) run with zero external runtime dependencies and pass the same conformance suite (tests/test_conformance.py).

What you bringExtensionsWhat dislop catchesKnown boundary
Drafts & docs.md, .mdx, .txtAI artifacts + throat-clearing openers, "Not X, but Y" pivots, staccato slogan runs, bureaucratic padding, four-character triads, moralizing endings, unsourced claims, bold-lead bullet walls, em-dash overuse, half-width CJK punctuationCode blocks, inline code, URLs, blockquotes, and dislop-quote blocks are masked for style rules
Web pages & components.html, .css, .jsx, .tsxDead <a href="#"> placeholder links, unexplained <button disabled>, purple-pink AI gradients, pill-badge walls, 3-level nested boxes, AI-Powered prompt-echo badgesStatic per-file inspection; runtime DOM state still needs browser tests
Word.docxJoined <w:t> runs, raw Markdown asterisks pasted from chat, and prose slop rules (para N)Reports paragraph number rather than rendered page number
PowerPoint.pptxPresentation slide order (p:sldIdLst), joined <a:t> runs, raw Markdown, slide word-walls (> 120 words / > 280 Han chars), bullet caps (> 6), <a:normAutofit> shrink (< 80%), generic titles (Overview, Background), layout monotony, and prose rulesHidden slides (show="0") are reported as [SKIP] for density checks
dislop.com offline browser workbench checking original draft, 2nd-order slop, and clean copy
Offline browser workbench in action
Auditing AI gradient, pill wall, and dead href='#' control before switching to clean 1px galley card
UI template slop audit before and after

Awesome Anti-Slop

Looking for other tools, style guides, design rules, PR policies, and papers in this space? Browse awesome/README.md (Chinese edition) or filter all 87 checked entries offline at dislop.com/awesome/ (machine-readable index.json and index.md).

Use it across agents, editors, and CI

SurfaceOne-liner or 1-click installWhat you get
Any AI chatPaste: Read https://dislop.com/llms.txt and apply its anti-slop rules and checks before delivering my next draft.Zero install; reads the ~2.4 KB index, task guides (/tasks/*.md), or atomic rule cards (/rules/<id>.md)
Agent Skill (75+ hosts)npx skills add dislop-ai/dislopInstalls pure-Markdown skills/dislop/SKILL.md + 4 local reference cards (0 bundled scripts, 0 network calls); guides local CLI checks when a shell exists
Claude Code Plugin/plugin marketplace add dislop-ai/dislop then /plugin install dislop@dislop-aiBundles pure-doc Skill + Official Cloud MCP connection (~130 always-on tokens)
OpenAI Codex Plugincodex plugin marketplace add dislop-ai/dislop then codex plugin add dislop@dislop-aiShips native UI card metadata (openai.yaml) and $dislop trigger
Gemini CLI Extensiongemini extensions install https://github.com/dislop-ai/dislopConnects Official Cloud MCP https://dislop.com/mcp via gemini-extension.json
Official MCP RegistrySearch io.github.dislop-ai/dislop on registry.modelcontextprotocol.ioLists the Official Cloud MCP endpoint https://dislop.com/mcp (Streamable HTTP)
VS Code / Cursor 1-Click MCPInstall in VS Code (Cloud MCP) · Install in Cursor (Cloud MCP)Opens the editor's native confirmation dialog without manual JSON edits
GitHub Action / pre-commitReference uses: dislop-ai/dislop@main (action.yml and .pre-commit-hooks.yaml)Gates modified lines in PRs with inline annotations or SARIF 2.1.0

Connect Official Cloud MCP (Claude Code, Codex, Cursor, WorkBuddy, Claude Cowork)

{
  "mcpServers": {
    "dislop": {
      "type": "http",
      "url": "https://dislop.com/mcp",
      "headers": {
        "Authorization": "Bearer dslp_your_token_here"
      }
    }
  }
}

Official Cloud MCP (https://dislop.com/mcp) exposes dislop_review (1 credit, genre-aware multi-model review returning structured issues and edit guidance for your local agent to apply in context), dislop_deslop (2 credits, re-checked rewrite), dislop_voice_extract (2 credits), and 0-credit deterministic checks. Sign in at dislop.com for a free 30-credit/month key.

Configure it, or overrule it

Run dislop init to create .dislop.json (put private local bans in Git-ignored .dislop.local.json):

{
  "failOn": "error",
  "ignore": ["vendor/**", "dist/**"],
  "overrides": [
    { "files": ["docs/**/*.md"], "pack": "business-brief" },
    { "files": ["essays/**/*.md"], "pack": "literary-essay" },
    { "files": ["site/**/*.{html,css,svg}"], "pack": "deck-and-ui" }
  ],
  "allow": ["Delve", "Bayeux Tapestry"],
  "rules": {
    "bold-lead-list-wall": "info"
  }
}

For a narrow one-off exception, add a reason above the line (--report-unused flags stale comments):

<!-- dislop-ignore-next-line en-cliche-lexicon -- quoting vendor press release verbatim -->

Install once locally (true air-gapped / fast hooks)

# Node.js 20+ (published on npm, < 250 KB tarball, zero network after install)
npm install -g dislop
dislop check .

# Or Python 3.10+ (published on PyPI, zero external dependencies)
pip install dislop
dislop check .

Open-Source Local (Skill + CLI) vs. Official Cloud (dislop.com/mcp)

  • Open Source (dislop-ai/dislop, Apache-2.0): Pure-Markdown SKILL.md + local ./references/*.md (no bundled scripts), zero-dependency Node/Python CLI (dislop check [--pack <id|auto>] [--profile] [--ml] [--patterns] [--changed [ref]] [--staged] [--format text|json|sarif|github|md], dislop patterns, dislop voice, dislop explain, dislop packs, dislop catalog, dislop resources), all 7 built-in packs (42 rules) + 53-pattern catalog (patterns/), bundled 14.6 KB gzip (49.0 KB raw) Pocket ML ensemble (models/pocket-slop-v1.json, < 0.5 ms, 100.0% F1 / 0.0% Clean FPR on stealth-vapor-v1), Awesome Anti-Slop, and dislop-bench v2. check / patterns / voice make 0 network calls so private drafts never leave your machine (existing --mcp and optional local-model modules stay in-repo during real-world evaluation).
  • Official Cloud MCP & Web Workbench (https://dislop.com/mcp, https://dislop.com/?lang=en#pricing): Closed-source hosted backend running paid-tier zero-training model endpoints (no draft logging; see privacy.md). Exposes dislop_review (1 credit, multi-model genre-aware review returning structured issues and edit guidance), dislop_deslop (2 credits, re-checked rewrite verifying numbers and qualifiers), and dislop_voice_extract (2 credits, dislop.voice/1). Sign-in required for cloud AI: claim a free key for 30 monthly credits, with early-access waitlists for Pro ($12/mo, 1,500 credits), PAYGO ($10 / 800 credits), and Team ($29/seat/mo).

Anti-slop benchmark (dislop-bench v2)

Run the full offline benchmark (112 cross-modality detection samples across Node & Python + 18 end-to-end writing and design tasks comparing raw AI, naive humanizers, and dislop-guided revisions):

node scripts/run_benchmark.mjs --assert

Latest measured baseline (benchmarks/REPORT.md and benchmarks/PATTERN-BENCHMARK.md):

  • Core Detection (Suite A, 112 samples = 48 v1 + 16 holdout-v1 + 48 text-hard-v2): Precision 100.0% · Recall 100.0% · Clean FPR 0.0% · Adversarial Near-Miss FPR 0.0% · 2nd-Order Trap Recall 100.0% · Node/Python Rule & Statistical Profile Parity 100.0%.
  • Multi-Angle Pattern Benchmark (154 samples = 48 + 16 + 62 pattern-challenge-v2 + 28 holdout-v2): Precision 100.0% · Recall 100.0% · F1 100.0% · Clean FPR 0.0% · Node/Python Parity 100.0%.
  • Bundled Pocket ML (stealth-vapor-v1, 24 paired samples; 36 blind eval with holdouts): 14.6 KB gzip (49.0 KB raw), < 0.5 ms, 100.0% F1, 0.0% Clean FPR.
  • End-to-End Revision (Suite B, 18 tasks = 12 revision-v1 + 6 revision-hard-v2, weights D1=45 / D2=20 / D3=25 / D4=10): raw_ai 60.8 / 100 → naive_humanizer 70.8 / 100 (doubles 3rd-order slop and drops or invents numbers) → dislop_clean 100.0 / 100 (18/18 all-clear).
  • Live 5-model comparison (benchmarks/MODEL-COMPARISON.md): Across Gemini 3.1/3.5 Flash-Lite, Gemini 3.5/3.8 Flash, and Qwen 3.8 Flash, bare prompts averaged 76.0–84.2 / 100 (2/10–4/10 all-clear on the 10-task revision-v1 live subset), while the dislop re-checked cloud pipeline lifted every model by +15.8 to +22.3 points (97.0–100.0 / 100, 8/10–10/10 all-clear; Gemini 3.1 Flash-Lite reached 98.5 / 100 in 1.2s at ~$0.09 / 1k calls).

See benchmarks/README.md to score your own model, Skill, or cloud endpoint (--eval) or export randomized blind human A/B review sheets (--export-blind-sheet).

dislop checks dislop

GitHub Actions CI runs dislop pack-test (164 fixture assertions in both Node and Python), 26 Python unittest conformance and engine tests across 4 modules (test_conformance, test_engine, test_pattern_library, test_pocket_and_local_models), pattern catalog checks (node scripts/pattern_lab.mjs verify and assert), and site checks (tests/test_site.mjs). It also runs dislop check . --fail-on warning across this repository's docs, awesome/, and site/.

Docs & layout

dislop/
├── .agents/plugins/   # OpenAI Codex marketplace manifest (marketplace.json)
├── .claude-plugin/    # Claude Code plugin & marketplace manifests (pure-doc Skill + Official Cloud MCP)
├── .codex-plugin/     # OpenAI Codex native plugin manifest & UI card metadata
├── plugin.json        # Agent Plugins 1.0 portable manifest (paired with root mcp.json)
├── gemini-extension.json # Gemini CLI Extension Gallery manifest
├── server.json        # Official MCP Registry manifest (Official Cloud HTTP MCP)
├── action.yml         # Reusable GitHub Marketplace incremental check Action
├── awesome/           # Awesome Anti-Slop (README.md & README.zh-CN.md, 87 entries)
├── benchmarks/        # Offline anti-slop benchmark datasets (CC0-1.0) & reproducible reports
├── bin/               # Node.js CLI (dislop.mjs) and compatibility launcher (dislop-mcp.mjs)
├── src/
│   ├── core.mjs       # Zero-dep ES module shared by Node CLI, MCP, and browser workbench
│   ├── pattern-engine.mjs # Multi-angle 11-probe extended pattern-bank scanner
│   ├── pocket-model.mjs# Bundled 14.6 KB gzip zero-dep Pocket ML ensemble & domain pack router
│   ├── local-model.mjs# Hardware-aware optional local small-model advisor (Node.js)
│   ├── binary-node.mjs# Zero-dep ZIP reader for Node.js (.docx / .pptx)
│   └── dislop/        # Zero-dep Python 3.10+ engine, pattern scanner, local-model advisor, CLI, and MCP
├── packs/             # Declarative dislop.pack/2 manifests (7 built-in packs, 42 rules, 160 fixtures)
├── patterns/          # Structured 53-pattern anti-slop catalog across 6 dimensions & 7 angles
├── skills/dislop/     # Cross-host Agent Skill (SKILL.md + local ./references/ + openai.yaml)
├── tests/             # 26 Python unittest suites, Node/Python conformance, and site tests
├── scripts/           # Manifest lockstep sync (sync_manifests.mjs), site compiler & benchmarks
├── site/              # Compiled dislop.com workbench, /awesome/, and /llms.txt pages
├── assets/            # Logo mark, light/dark banners, and 1200x630 social preview card
└── docs/              # Brand guide, architecture, design system, roadmap, and research

License

Apache License 2.0

No installation packages available.

Remote

streamable-http
https://dislop.com/mcp