简体中文 · 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
Metadata
Release files for dislop 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| dislop-0.7.0.tar.gz | 209.8 kB | With provenance | Details for dislop-0.7.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| dislop-0.7.0-py3-none-any.whl | Python 3 | none | any | Details for dislop-0.7.0-py3-none-any.whl |
Total release size: 402.6 kB
Release files / dislop-0.7.0.tar.gz
| Download URL | dislop-0.7.0.tar.gz |
|---|---|
| Size | 209.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
84b91e21f92e6be2bc0db91971355f2659b3239b7174d33396ec7606861c82b4
|
|
BLAKE2b-256 checksum How to use checksums |
fec4e24835dcec78527c420a03904e27b22793d432f631cc73eb570ad3ee3674
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logRelease files / dislop-0.7.0-py3-none-any.whl
| Download URL | dislop-0.7.0-py3-none-any.whl |
|---|---|
| Size | 192.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cb67979931162b34649ada0484b84ffd3fc1ba04aa219f3d7c28008444a295a3
|
|
BLAKE2b-256 checksum How to use checksums |
f9afb28dcc239f295be588d4735c76b78f4d96cc00c34c264c900d5f92b7f840
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logSecurity for dislop 0.7.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for dislop-0.7.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.