slopless 0.2.20 → 0.2.22

package/README.md

@@ -2,44 +2,35 @@
 
 [![npm](https://img.shields.io/npm/v/slopless?label=npm)](https://www.npmjs.com/package/slopless)
 [![downloads](https://img.shields.io/npm/dm/slopless)](https://www.npmjs.com/package/slopless)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/slopless?label=minzip)](https://bundlephobia.com/package/slopless)
 [![install size](https://packagephobia.com/badge?p=slopless)](https://packagephobia.com/result?p=slopless)
 [![license](https://img.shields.io/npm/l/slopless)](LICENSE)
 [![node](https://img.shields.io/badge/node-22%2B-brightgreen)](package.json)
 
 [![ci](https://img.shields.io/github/actions/workflow/status/seochecks-ai%2Fslopless/ci.yml?branch=main&label=ci)](/actions/workflows/ci.yml)
-[![scorecard](https://api.scorecard.dev/projects/github.com/seochecks-ai/slopless/badge)](https://scorecard.dev/viewer/?uri=github.com/seochecks-ai/slopless)
 [![socket](https://socket.dev/api/badge/npm/package/slopless)](https://socket.dev/npm/package/slopless)
-[![snyk advisor](https://snyk.io/advisor/npm-package/slopless/badge.svg)](https://snyk.io/advisor/npm-package/slopless)
 
-Catch AI and human slop in English Markdown without calling an LLM. Slopless ships 50+ deterministic textlint rules and a CLI that emits structured JSON findings.
+Give it to your writing agent and it stops handing you AI-slop prose. Slopless is a deterministic linter - a textlint preset and a zero-config CLI - that flags the LLM tells (hollow framing, fake contrasts, hedging, em-dash tics, vacuous closers, and many more) so the agent rewrites until the text reads human. No model calls, no API key.
 
 ## What it catches
 
-Given this paragraph (typical LLM prose):
+Given this paragraph of confident-sounding slop:
 
 ```markdown
-In today's rapidly evolving landscape, it's important to note that AI tools
-are revolutionizing how we work - truly transforming workflows in
-unprecedented ways. By harnessing the power of large language models, teams
-can delve into complex challenges, streamline operations, and unlock new
-possibilities. But what does this really mean for you? In essence, the
-future belongs to those who embrace these tools today. Not just to keep up,
-not just to stay competitive, but to thrive.
+Let me be honest: in a world where everyone is racing to ship, most teams
+forget the basics. We do not sell software. We sell outcomes. Everyone knows
+the best products feel effortless. At the end of the day, the future belongs
+to the teams that slow down to think.
 ```
 
-`npx slopless` returns nine findings across seven rules:
+`npx slopless` flags six findings across five rules - structure and rhetoric, not just a word list:
 
 ```
-[slopless/generic-signposting]  it's important to note
-[slopless/prohibited-phrases]   it's important to note
-[slopless/llm-vocabulary]       landscape
-[slopless/llm-vocabulary]       delve
-[slopless/prohibited-words]     delve
-[slopless/prohibited-words]     unlock
-[slopless/prohibited-phrases]   the future belongs to
-[slopless/negation-reframe]     Not just X, not just Y, but Z
-[slopless/flesch-kincaid]       Flesch Reading Ease 56.05 (keep >= 61)
+[slopless/boilerplate-framing]    let me be honest
+[slopless/prohibited-phrases]     in a world where
+[slopless/negation-reframe]       We do not sell software. We sell outcomes.
+[slopless/universalizing-claims]  everyone knows
+[slopless/cliches]                at the end of the day
+[slopless/prohibited-phrases]     the future belongs to
 ```
 
 Full JSON output is the default. See the [Rules](https://github.com/seochecks-ai/slopless/wiki/Rules) page for the complete inventory.
@@ -48,6 +39,7 @@ Full JSON output is the default. See the [Rules](https://github.com/seochecks-ai
 
 ```bash
 npm install -D slopless
+npx slopless --help
 npx slopless install-skill codex
 npx slopless install-skill claude
 ```
@@ -61,14 +53,18 @@ Use the Slopless skill. Check this Markdown, rewrite the prose, and keep iterati
 Loop:
 
 1. Install Slopless.
-2. Install the agent skill for Codex or Claude Code.
-3. Tell the writing agent to use the skill.
-4. Let the agent run Slopless, rewrite, and rerun until the JSON output has no findings.
-5. Profit.
+2. Read the core help (`npx slopless --help`).
+3. Install the agent skill for Codex or Claude Code.
+4. Tell the writing agent to use the skill.
+5. Let the agent run Slopless, rewrite, and rerun until the JSON output has no findings.
+6. Profit.
+
+## Set up the CLI
 
-## Direct CLI Use
+The CLI bundles textlint, so it needs no separate textlint install and no `.textlintrc`. This is the recommended path for writing agents and one-off checks.
 
 ```bash
+npm install -D slopless
 npx slopless "docs/**/*.md"
 ```
 
@@ -83,6 +79,30 @@ mkdir -p .slopless/findings
 npx slopless "docs/**/*.md" > ".slopless/findings/$(date +%Y-%m-%d-%H%M%S)--review.json"
 ```
 
+## Set up the textlint preset
+
+If you already run [textlint](https://textlint.github.io/), add slopless as a preset instead. It runs through your existing textlint, alongside your other rules and `.textlintrc`, and supports textlint's output formatters (the CLI is always JSON).
+
+```bash
+npm install -D slopless textlint
+```
+
+Add `preset-slopless` to your `.textlintrc.json`:
+
+```json
+{
+  "rules": {
+    "preset-slopless": true
+  }
+}
+```
+
+```bash
+npx textlint "docs/**/*.md"
+```
+
+Findings use the same `slopless/<rule>` ids as the CLI. Turn off individual rules with `"preset-slopless": { "cliches": false }`. To honor the `<!-- textlint-disable -->` blocks below, also `npm install -D textlint-filter-rule-comments` and add `"filters": { "comments": true }` to the config.
+
 ## Agent Use
 
 Agents should run help first:
@@ -144,6 +164,10 @@ This confirms the tarball you installed was built in the published source reposi
 
 [![Star History Chart](https://api.star-history.com/svg?repos=seochecks-ai/slopless&type=Date)](https://star-history.com/#seochecks-ai/slopless&Date)
 
+## Credits
+
+[Graham Rowe](https://github.com/grahamrowe82/antislop), thanks for giving me new ideas for classes of slop to detect. Your lib is now fully incorporated with your permission.
+
 ---
 
 Developed by [seochecks.ai](https://seochecks.ai) to keep content specific, useful, and recognizably human.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slopless",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Deterministic textlint rules and CLI for catching prose slop in English Markdown.",
   "keywords": [
     "textlint",
@@ -124,7 +124,6 @@
     "textlint-util-to-string": "3.3.4"
   },
   "devDependencies": {
-    "@double-great/stylelint-a11y": "3.4.13",
     "@eslint-community/eslint-plugin-eslint-comments": "4.7.1",
     "@types/node": "22.19.19",
     "@typescript-eslint/eslint-plugin": "8.59.4",
@@ -132,15 +131,9 @@
     "cspell": "10.0.0",
     "eslint": "10.4.0",
     "eslint-plugin-import-x": "4.16.2",
-    "eslint-plugin-regexp": "3.1.0",
     "eslint-plugin-sonarjs": "4.0.3",
     "eslint-plugin-unicorn": "64.0.0",
-    "g3ts-eslint-plugin-style-policy": "0.1.3",
-    "jscpd": "4.2.3",
     "prettier": "3.8.3",
-    "stylelint": "17.12.0",
-    "stylelint-config-standard": "40.0.0",
-    "stylelint-config-tailwindcss": "1.0.1",
     "syncpack": "15.3.1",
     "type-coverage": "2.29.7",
     "typescript": "6.0.3"
@@ -150,9 +143,8 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint --max-warnings 0 .",
-    "lint:css": "stylelint --max-warnings 0 \"styles/**/*.css\"",
     "spellcheck": "cspell .",
     "typecov": "type-coverage --strict --at-least 100",
-    "validate": "pnpm run build && node scripts/verify-cli-version.mjs && pnpm run lint && pnpm run lint:css && prettier --check . && cspell . && type-coverage --strict --at-least 100"
+    "validate": "pnpm run build && node scripts/verify-cli-version.mjs && pnpm run lint && prettier --check . && cspell . && type-coverage --strict --at-least 100"
   }
 }