All / Publishing and quality

Clarity Gate

Before voicing, fresh cheap readers (a 12 year old, a non-native speaker, a distracted viewer) read the script. Lint first, then headless reader calls about $0.03 a round. Narration changed after a pass must pass again.

What to say

Run the clarity gate on this script and tell me which beats fail.

How it works

  1. storyboard_lint.py
  2. clarity_lint.py
  3. gate_read.py --pass

At a glance

Best for
  • Any explainer
You give
  • script.json and shots.json
You get
gate/passed.json
Time
Minutes
Cost
About $0.03 per round

Good to know

  • If a beat keeps failing, cut it instead of patching (the cap warning appears after round 3)

Docs in the repo

  • docs/video-clarity.md
  • docs/clarity-calibration.md

Examples (real results, first 24 seconds)

No sample render of this one is checked in yet. Ask for it and the first result becomes the example.

Related