The rule set

Ten files. Read them in order.

Start with SKILL.md for the workflow, then calibration.md for how to score. Then walk the AI-slop axis (patterns, vocabulary, formatting) and the comprehension axis (comprehension, readability).

  1. 01SKILL.md→
  2. 02Calibration→
  3. 03Patterns→
  4. 04Vocabulary→
  5. 05Formatting tells→
  6. 06Comprehension→
  7. 07Readability metrics→
  8. 08Audit report template→
  9. 09Sources→
  10. 10scan.py
MetaSKILL.md
SKILL.md

Entry point for the agent. Modes (audit vs fix), when to skip, the workflow, and the top-20 lethal items.

Read →
MetaCalibration
references/calibration.md

Density formula, severity tiers, genre adjustments, model fingerprints, contested-tell handling. Read this first.

Read →
AI-SlopPatterns
references/patterns.md

45 rhetorical and structural patterns across 5 groups. The bulk of the AI-slop axis.

Read →
AI-SlopVocabulary
references/vocabulary.md

~150 word-level tells across 7 categories: LLM verbs, cliché metaphors, intensifiers, sycophancy, weasels, connectors, spike words.

Read →
AI-SlopFormatting tells
references/formatting-tells.md

~33 markdown and structural patterns: bold-first bullets, title clichés, repetition, whitespace artifacts.

Read →
ComprehensionComprehension
references/comprehension.md

35 patterns across 5 groups for the comprehension axis: density overload, telegraphic compression, audience assumptions, scannability, cognitive friction.

Read →
ComprehensionReadability metrics
references/readability-metrics.md

Eight readability formulas with audience targets and the three cold-reader density signals (acronyms, named entities, numerics).

Read →
MetaAudit report template
references/audit-report-template.md

Canonical dual-verdict output: AI-slop and Comprehension scores, top fixes, mechanical and qualitative violations, recommended action.

Read →
MetaSources
references/sources.md

~50 published sources backing every pattern. Peer-reviewed linguistics, vendor methodology, practitioner literature, viral takedowns.

Read →
Scannerscan.py
scripts/scan.py

Python regex scanner. Density-aware scoring, genre flags, model fingerprinting. JSON / quick / human modes.

Read →