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 →