Skip to content

Jev directory

Slop Grader

A CLI that grades markdown and text files against plain-Markdown rulesets with Jev, running every rule against every line in parallel and caching unchanged lines to avoid repeat API calls.
Stars
35
Language
TypeScript
License
MIT
Reading time
3 min
Published by
Community
Author
lukstei
Last verified
Sep 2026

About this project

Rule-based slop grader for text files, powered by Jev. Runs every rule against every line in parallel. No skimming, no missed lines. slop-grader runs as a two-step loop: grade text with the CLI, then paste the output to your AI agent to plan the improvements. Run slop-grader on a document like examples/slop.md: Pass the output to your AI agent: The agent distinguishes real violations from false positives and generates concrete replacements (Example with Gemini 3.8 Flash):

Quoted from the project's README. Read the full README.

Highlights

  • Groups lines into batches of up to 255 per rule and evaluates document-level rubrics in one request across the whole text.
  • Line evaluations are cached by content hash and rule criteria, so unchanged lines cost zero API calls; --no-cache bypasses the cache.
  • Built-in rulesets cover AI writing patterns, tech docs, grammar, and document scores, and rules validate offline with --check.
  • Checking a 16-line example against 53 rules costs roughly $0.0053, and results are available as terminal text or structured JSON.

Quickstart

bash
npx @lukstei/slop-grader@latest -r no-ai-slop examples/slop.md

Watch out

MIT-licensed. Needs Node.js and a TYPESAFE_API_KEY or OPENROUTER_API_KEY; flagged lines may be false positives that a human or agent pass is expected to filter.

Questions about this entry

Short answers drawn from the linked project or page.

From the Jev guides

Original write-ups on what this entry is for.

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai