RicksClips MCP

Private MCP server + docs for the RicksClips Skill V1.2.1 (fast-only camera).

Fast camera rules (R1–R12)

Practitioner consensus (Shortzly, Splice, ClickyApps, Zella), not peer-reviewed studies. Fast is a TEST — validate by A/B before locking in. The old slow system (V1.1: median shot ~17 s, ~0.4 cuts/10 s, camera at rest 30%+) was removed in V1.2.1.

#RuleNumberEnforced by
R1Max shot length 6 s, except one whitelisted contrast beat6 space_check.py, film_plan.py
R2Target ASL 2.5–4 s; ≥10 visual changes per 60 s (target 12–20)ASL 2.5–4 space_check.py, film_plan.py
R3Camera moving ≥90% of frames; no rest over 0.5 s outside a whitelisted beat≥90%, rest ≤0.5 sfilm_plan.py
R4Every narration line maps to ≥1 visual (scene change, insert, prop gag, caption change, zoom punch); a line with no visual is rewritten1 visual / linepace_check.py
R5Hook: first visual change within 2 s, first question/open loop within 3 s≤2 s / ≤3 space_check.py
R6Vary rhythm: ≤3 consecutive shots at the same length; fast cuts at high energy, 4–6 s for emotional/complex beats≤3 in a rowpace_check.py
R7Sound: ≤6 SFX per 60 s (target 3), structural cuts only; SFX ≤−6 dB vs speech; whoosh peak exactly on the split; never over spoken words≤6, −6 dBaudio-mix check (manual)
R8Captions: every line captioned; keyword pop on punch word; anim 0.2–0.5 s; ~3 words/s0.2–0.5 scaption track
R9No cut mid-sentence; cuts land on pauses or on the punch word0 mid-sentence cutspace_check.py
R10One deliberate slow/contrast beat per Short (0.5–1 s hold after the key line, or one 4–6 s slower shot), whitelisted1 per Shortpace_check.py, film_plan.py
R11Audit every render with PySceneDetect (AdaptiveDetector): report ASL, cuts/10 s, longest shot; fail if R1/R2 breached—WORKFLOW step 10
R12A/B before locking in: the fast cut must beat the archived V1.1 slow cut of the same story on retention/views—process, not a tool

Fast vocabulary

Fast cutting HURTS when: the cut carries no new information, it lands mid-sentence, or the rhythm is monotone.

How the tools enforce pace

python tools/film_plan.py check episodes/<name>/film.json
python tools/pace_check.py check episodes/<name>/film.json [--script two-column.md]
# R11 audit (PySceneDetect, install once on the PC):
pip install scenedetect
scenedetect -i film.mp4 detect-adaptive list-scenes