Checks

agentfeed check decides whether a video can be published. The worker runs it on every video; so does Agent Feed Cloud.

agentfeed check <job folder>

It exits with 0 when the video passes, and 1 when it doesn't.

What it checks

AreaThe video passes when
VoiceThe 3b1b voice score is at least 83, with no dimension under 60. It's measured again on the final video. With the local voice, at least 70.
FormatIt's 1080×1920 at 60 frames a second, and 25 to 100 seconds long.
HookThe narration starts within 0.5 seconds, and frame 0 already shows something.
PacingSomething moves from the start, and something happens on screen at least every 2 seconds. No still stretch is longer than 1.5 seconds. The final hold is at most 0.6 seconds.
LayoutNo text is too small (under 40 pixels tall), overlaps other text, comes in late, or leaves the safe area.
Safe zonesNothing important sits under the iPhone app's buttons: the top bar, the right-hand rail, and the bottom.
LoopThe last frame matches the first, so the video loops.
ButtonsOnly for a video with sections or buttons: they're the storyboard's, each section starts on its beat, they keep Agent Feed's rules, and nothing is drawn where a button sits while it shows, frame by frame.

What it prints

verdict: PASS  (54.2 s, 3b1b voice score 88.4)
  look at: …/out/keyframes.jpg (one frame per beat) and …/out/contact.jpg

A failed check says what failed, and how to fix it:

verdict: FAIL  (54.2 s, 3b1b voice score 88.4)
  FAIL [loop] last frame matches frame 0: similarity 0.91
       fix: end on the same composition as frame 0
  look at: …/out/keyframes.jpg (one frame per beat) and …/out/contact.jpg

Pictures to look at

  • out/keyframes.jpg: one frame per beat, where the beat settles.
  • out/contact.jpg: twelve frames, spread over the whole video.

The full verdict is in out/check.json.

When a check fails

In the background, the worker goes back to the scene once, with what failed. If the video still fails, the job stops, and the session gets a message that says why. agentfeed work <job folder> runs it again.