/script-judges

name: script-judges
description: A four-judge adversarial panel for short-video script lines (UGC ads, talking-head, mini-drama, 口播/带货台词). Every judge owns exactly one axis — retention pacing, spoken-not-written voice, freshness, structure — and tears the script apart BEFORE any generation money is spent, then rewrites the lines so they sound spoken, not written. Use when the user writes or reviews short-video scripts, voiceover lines, hooks, or UGC ad copy, or asks "why does my script sound like an ad".
license: AGPL-3.0-only
compatibility: Pure-text skill, no binaries required — works in any agent host. Pairs with a local ClipForge instance (apply rewrites via its scripts PATCH API or the in-app judge panel), but stands alone for any script work.
metadata:
  {
    "version": "0.8.83",
    "homepage": "https://github.com/xixihhhh/clipforge",
    "keywords": "script-review, ugc-ads, hook-writing, short-video, copywriting, 口播, 带货脚本, 台词, judge-panel",
    "openclaw":
      {
        "emoji": "⚖️",
        "homepage": "https://github.com/xixihhhh/clipforge",
        "requires": {},
      },
  }

Script judges — tear the lines apart before you spend a cent

Video models render a bad script exactly as pretty as a good one. Once the footage passes as human, retention lives or dies on whether the LINES sound spoken or written. So the script gets torn apart first — by narrow, bad-tempered specialists, not one polite generalist.

**How to use**: give the panel a script (numbered lines or per-shot voiceover). Run ALL four judges, each strictly from its own angle. Then rewrite. Then run the panel again. A script only graduates when every judge passes it.

The four judges

Play each judge as a separate, single-minded reviewer. Harsh beats kind; a judge that finds nothing is suspicious.

1. 节奏官 — the pacing judge

Owns exactly one thing: does the viewer stay?

• The first line is a death-penalty checkpoint: if it wouldn't stop a thumb mid-scroll, the script is dead — no other virtue can save it.
• Every line must make the next line wanted. Flag any sentence that answers a question nobody asked.
• Flag long winding sentences and low-information filler. Spoken lines are short.

2. 口语官 — the spoken-voice judge

Owns exactly one thing: does it sound SAID, not WRITTEN?

• Hooks start mid-conversation — the viewer scrolled in halfway. "大家好 / 今天给大家介绍 / Hi everyone" openers are instant kills.
• Filler words ("就是", "说真的", "I mean") and one half-finished thought are GOOD — sparingly, once or twice per script.
• Written-prose connectives ("因此 / 综上所述 / therefore / in conclusion") are kills. Punchline endings and life-lesson closers are kills.
• CTAs must sound offhand ("反正链接我放这了" / "anyway, link's down there") — never a slogan.
• The test: read it aloud. Anything that sounds like copy gets rewritten as speech.

3. 创意官 — the freshness judge

Owns exactly one thing: has the viewer seen this before?

• Flag template openers, worn-out memes, and any line that every competing video in the niche would also say.
• Flag "safe" claims that could describe any product. Specifics beat adjectives; one concrete detail beats three superlatives.

4. 结构官 — the structure judge

Owns exactly one thing: does the whole thing build and land?

• Setup → escalation → landing must actually escalate. Flag scripts that plateau after the hook.
• Endings that land on a lesson, a moral, or a golden line are violations — end where the thought trails off or gets interrupted.
• A slogan-shaped CTA is a violation (that's also the voice judge's kill — they agree on this one).

Feeding the judges (calibration corpus)

Judges are only as sharp as what they're fed. Before serious use, paste calibration material below each judge's section in your working copy:

• Transcripts of creators whose videos actually stop YOUR thumb — hooks, full voiceovers, topic choices.
• A "proven scripts" baseline: scripts (yours or studied) behind videos with real performance numbers.

**The iron rule — easy to get backwards**: at least one judge (the spoken-voice judge) must be fed ONLY real creators' raw transcripts — never award-winning ad copy. UGC lines are not supposed to sound well-written; a judge calibrated on polished copywriting will "improve" every script into an ad, which is the exact failure this panel exists to prevent.

Rewrite rules

• Keep the meaning, the selling points, and every factual claim. Change only HOW it's said. Never add new efficacy/price claims (ad-law red line).
• Keep each rewritten line within ±20% of the original length — voiceover duration is usually pinned to shot slots by TTS.
• Rough beats polished. If it reads like copy, rewrite it as speech.
• Across a batch, vary the person, the setting and the phrasing patterns — repetition is the biggest tell.
• If the hook wouldn't hold you, say so BEFORE anything gets generated. If a claim isn't supported by the product, flag it.

With ClipForge

ClipForge ships this panel built in: the script page's ⚖️ judge-panel button runs all four judges in one LLM call and applies rewrites through `PATCH /api/project/{id}/scripts` (`shotTexts`). As an agent you can do the same: `POST /api/project/{id}/script-judge { scriptId, llmConfig }` returns `{ verdicts, rewrites, summary }`, then PATCH the rewrites you accept. Judging is cheap (one text call); generation is not — always judge first.