
dislop
io.github.dislop-ai/dislop
Linter for AI Slop in docs, web UI, and slides — Official Cloud MCP.
Documentation
简体中文 · 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.
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 .
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:
- 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. - 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, andexecutive-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 bring | Extensions | What dislop catches | Known boundary |
|---|---|---|---|
| Drafts & docs | .md, .mdx, .txt | AI 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 punctuation | Code blocks, inline code, URLs, blockquotes, and dislop-quote blocks are masked for style rules |
| Web pages & components | .html, .css, .jsx, .tsx | Dead <a href="#"> placeholder links, unexplained <button disabled>, purple-pink AI gradients, pill-badge walls, 3-level nested boxes, AI-Powered prompt-echo badges | Static per-file inspection; runtime DOM state still needs browser tests |
| Word | .docx | Joined <w:t> runs, raw Markdown asterisks pasted from chat, and prose slop rules (para N) | Reports paragraph number rather than rendered page number |
| PowerPoint | .pptx | Presentation 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 rules | Hidden slides (show="0") are reported as [SKIP] for density checks |
![]() Offline browser workbench in action |
![]() 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
| Surface | One-liner or 1-click install | What you get |
|---|---|---|
| Any AI chat | Paste: 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/dislop | Installs 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-ai | Bundles pure-doc Skill + Official Cloud MCP connection (~130 always-on tokens) |
| OpenAI Codex Plugin | codex plugin marketplace add dislop-ai/dislop then codex plugin add dislop@dislop-ai | Ships native UI card metadata (openai.yaml) and $dislop trigger |
| Gemini CLI Extension | gemini extensions install https://github.com/dislop-ai/dislop | Connects Official Cloud MCP https://dislop.com/mcp via gemini-extension.json |
| Official MCP Registry | Search io.github.dislop-ai/dislop on registry.modelcontextprotocol.io | Lists the Official Cloud MCP endpoint https://dislop.com/mcp (Streamable HTTP) |
| VS Code / Cursor 1-Click MCP | Install in VS Code (Cloud MCP) · Install in Cursor (Cloud MCP) | Opens the editor's native confirmation dialog without manual JSON edits |
GitHub Action / pre-commit | Reference 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-MarkdownSKILL.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 (42rules) + 53-pattern catalog (patterns/), bundled14.6 KBgzip (49.0 KBraw) Pocket ML ensemble (models/pocket-slop-v1.json,< 0.5 ms,100.0%F1 /0.0%Clean FPR onstealth-vapor-v1),Awesome Anti-Slop, anddislop-bench v2.check/patterns/voicemake0network calls so private drafts never leave your machine (existing--mcpand 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). Exposesdislop_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), anddislop_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 + 16holdout-v1+ 48text-hard-v2): Precision100.0%· Recall100.0%· Clean FPR0.0%· Adversarial Near-Miss FPR0.0%· 2nd-Order Trap Recall100.0%· Node/Python Rule & Statistical Profile Parity100.0%. - Multi-Angle Pattern Benchmark (
154samples = 48 + 16 + 62pattern-challenge-v2+ 28holdout-v2): Precision100.0%· Recall100.0%· F1100.0%· Clean FPR0.0%· Node/Python Parity100.0%. - Bundled Pocket ML (
stealth-vapor-v1, 24 paired samples; 36 blind eval with holdouts):14.6 KBgzip (49.0 KBraw),< 0.5 ms,100.0%F1,0.0%Clean FPR. - End-to-End Revision (
Suite B, 18 tasks = 12revision-v1+ 6revision-hard-v2, weightsD1=45 / D2=20 / D3=25 / D4=10):raw_ai60.8 / 100 →naive_humanizer70.8 / 100 (doubles 3rd-order slop and drops or invents numbers) →dislop_clean100.0 / 100 (18/18all-clear). - Live 5-model comparison (benchmarks/MODEL-COMPARISON.md): Across
Gemini 3.1/3.5 Flash-Lite,Gemini 3.5/3.8 Flash, andQwen 3.8 Flash, bare prompts averaged76.0–84.2 / 100(2/10–4/10all-clear on the 10-taskrevision-v1live subset), while thedislopre-checked cloud pipeline lifted every model by +15.8 to +22.3 points (97.0–100.0 / 100,8/10–10/10all-clear;Gemini 3.1 Flash-Litereached98.5 / 100in1.2sat~$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
- Product Brief · Brand & Voice Guide (zh-CN)
- Architecture (zh-CN) · Design System (zh-CN)
- Roadmap (zh-CN) · Releasing · Contributing · Research Index · Changelog
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
No installation packages available.

