Skip to content
Skills Library
Marketing & content · Review & audit

script-evaluator

/script-evaluator

Evaluate video scripts and presentations for flatness, tension, and emotional impact. Use when: 'is this script good', 'review script', 'evaluate video', 'why is this boring', 'flatness check', 'script review', 'improve script', 'rate this video'. Scores 6 dimensions (tension, specificity, emotional arc, hook, customer voice, visual variety), identifies specific problems, and suggests concrete fixes with examples. Do NOT use to generate a new script or scene structure from scratch (use video-narrative-arc), to build the product brief (use product-meaning-extractor), or to render/finish the vid

Licence
MIT
Last repository change
24.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Evaluate video scripts and presentations for flatness, tension, and emotional impact. Use when: 'is this script good', 'review script', 'evaluate video', 'why is this boring', 'flatness check', 'script review', 'improve script', 'rate this video'. Scores 6 dimensions (tension, specificity, emotional arc, hook, customer voice, visual variety), identifies specific problems, and suggests concrete fixes with examples. Do NOT use to generate a new script or scene structure from scratch (use video-narrative-arc), to build the product brief (use product-meaning-extractor), or to render/finish the vid

Triggers from the description

is this script goodreview scriptevaluate videowhy is this boringflatness checkscript reviewimprove scriptrate this video
Original author description

Evaluate video scripts and presentations for flatness, tension, and emotional impact. Use when: 'is this script good', 'review script', 'evaluate video', 'why is this boring', 'flatness check', 'script review', 'improve script', 'rate this video'. Scores 6 dimensions (tension, specificity, emotional arc, hook, customer voice, visual variety), identifies specific problems, and suggests concrete fixes with examples. Do NOT use to generate a new script or scene structure from scratch (use video-narrative-arc), to build the product brief (use product-meaning-extractor), or to render/finish the vid

How it works

  1. Preserve facts before scoring style
  2. Evaluation: 6 Dimensions (score each 1-10)
  3. Scoring
  4. 5 Common Flatness Patterns
  5. Usage
  6. Gotchas
  7. Troubleshooting
  8. Source basis
Original SKILL.md headings · 155 lines, 1,179 words
SKILL.md preview
---
name: script-evaluator
description: "Evaluate video scripts and presentations for flatness, tension, and emotional impact. Use when: 'is this script good', 'review script', 'evaluate video', 'why is this boring', 'flatness check', 'script review', 'improve script', 'rate this video'. Scores 6 dimensions (tension, specificity, emotional arc, hook, customer voice, visual variety), identifies specific problems, and suggests concrete fixes with examples. Do NOT use to generate a new script or scene structure from scratch (use video-narrative-arc), to build the product brief (use product-meaning-extractor), or to render/finish the video (use remotion-production-guide or video-post-production); this only critiques an existing script/scene."
---

# Script Evaluator / Flatness Detector

Review a video script, presentation, or rendered scene code and identify exactly WHY it's boring and HOW to fix it. Works on scripts, storyboards, and Remotion/code-based video scenes.

## Preserve facts before scoring style

Check claims against the supplied brief and its sources. Keep factual numbers,
comparisons, product capabilities, and customer quotations tied to their evidence
and limitations. The examples below are illustrative, not reusable product facts.
Never invent a statistic, customer, testimonial, or guarantee to raise a score.
Without evidence, use a supported qualitative example or flag the exact claim as
unverified while continuing the rest of the review. A creative score is a heuristic,
not a measured engagement prediction, factual approval, or authority to publish.

## Evaluation: 6 Dimensions (score each 1-10)

### 1. TENSION - Does the viewer feel something?

| Score | Description |
|-------|-------------|
| 1-3 | No enemy/problem. Features listed without context. "We do X, Y, Z" tone |
| 4-6 | Problem mentioned but vague ("saves time"). Some contrast but generic |
| 7-10 | Specific visceral enemy. Clear before→after. Viewer thinks "that's me!" |

**Fix:** Name the specific, observed pain. Use attributed customer language or clearly identified paraphrases. Show the "before" state without exaggerating it; add a number only when its source supports the claim.

### 2. SPECIFICITY - Is it concrete or vague?

| Red Flag | Fix |
|----------|-----|
| "Saves time" | HOW MUCH? "Saves 45 minutes per photo" |
| "Better quality" | WHAT metric? "Original DPI, pixel-to-pixel" |
| "Innovative solution" | WHAT innovation? "Neural retouching with layer output" |
| "AI-powered" | What does the AI DO? "Detects and removes 12 types of artifacts" |
| "Trusted by thousands" | WHO? "Used by 500+ jewelry studios including [name]" |

**Rule:** Prefer a supported concrete example over a vague adjective. Numbers are optional; retain scope and uncertainty rather than forcing numerical specificity.

### 3. EMOTIONAL ARC - Does it go somewhere?

| Score | Description |
|-------|-------------|
| 1-3 | Same energy start to finish. Feels like a slideshow of facts |
| 4-6 | Some variation but no clear peak/valley |
| 7-10 | Identifiable beats. At least one DOWN (tension) and one UP (relief). Last scene feels different from first |

**Fix:** Map scenes to an emotional curve. Must have at least one DOWN (problem) and one UP (amazement/relief). The CTA should feel like resolution, not another slide.

### 4. HOOK STRENGTH - Will they keep watching?

| Score | Description |
|-------|-------------|
| 1-3 | Starts with logo, "We are [company]...", or decorative intro with no information |
| 4-6 | Has information but doesn't create urgency or curiosity |
| 7-10 | First frame has surprising information. Creates curiosity gap. Uses customer language. MUST see next scene |

**Fix:** The hook is your ad for your ad. Read the first 3 seconds aloud. If it sounds like a corporate intro, try a relevant question, supported fact, attributed customer quote, or clear visual contrast. A stronger hook must not strengthen a claim beyond its evidence.

### 5. CUSTOMER VOICE - Does it sound human?

| Score | Description |
|-------|-------------|
| 1-3 | "Leveraging cutting-edge technology." "Seamless integration." "World-class results." |
| 4-6 | Reasonable language but still "written by marketing" feeling |
| 7-10 | Actual customer phrases. Sounds like describing to a friend. Simple, direct, concrete |

**Fix:** Use relevant available customer reviews with source, attribution, date/context, and faithful wording. No fixed quote quota. If no reviews are available, use plain explanatory copy; never fabricate or present inferred language as a testimonial.

### 6. VISUAL VARIETY - Is it visually dynamic?

| Score | Description |
|-------|-------------|
| 1-3 | Same layout every scene. All text, no imagery. Same animation everywhere |
| 4-6 | Some variation but key moment doesn't stand out visually |
| 7-10 | 2+ visual styles. Pacing matches emotion. Most important scene looks DIFFERENT |

**Fix:** Alternate scene types. After text-heavy scenes, do a visual scene. The most important scene should have a unique visual treatment.

## Scoring

```
TENSION:        _/10
SPECIFICITY:    _/10
EMOTIONAL ARC:  _/10
HOOK:           _/10
CUSTOMER VOICE: _/10
VISUAL VARIETY: _/10
────────────────────
TOTAL:          _/60

VERDICT:
  50-60: Strong on this creative rubric; check factual and task acceptance separately
  40-49: Good, minor tweaks needed  
  30-39: Needs work on weakest dimensions
  20-29: Major rewrite - go back to Product Brief
  <20:   Start over with Product Meaning Extractor
```

## 5 Common Flatness Patterns

### 1. "Feature Parade"
**Symptom:** Scene 1: Feature A. Scene 2: Feature B. Scene 3: Feature C. CTA.
**Why flat:** No narrative tension. It's a list, not a story.
**Fix:** Add a problem scene BEFORE features. Features answer a question - ask the question first.

### 2. "Logo-First"
**Symptom:** Opens with 3-5 seconds of logo animation.
**Why flat:** Nobody cares about your logo yet. They care about their problem.
**Fix:** Move logo to the END. Open with the hook.

### 3. "Generic Superlatives"
**Symptom:** "The best solution." "Revolutionary technology." "World-class results."
**Why flat:** Every product says this. These words carry zero information.
**Fix:** Replace with supported specifics. A measured speed comparison needs its source and conditions; otherwise explain the actual workflow improvement without a made-up multiplier.

### 4. "Missing Middle"
**Symptom:** Good hook, good CTA, flat middle that walks through features.
**Why flat:** No emotional peak. The demo section needs a WOW moment.
**Fix:** Find the single most impressive thing the product does. Build to it. Make it visually different from everything else.

### 5. "Uniform Energy"
**Symptom:** Every scene has same pacing, animation speed, text size.
**Why flat:** No rhythm. Like music at one volume.
**Fix:** Vary tempo: fast cuts → slow hero shot → medium features → fast proof → slow CTA.

## Usage

After writing a script or coding scenes:
```
"Evaluate this script/video using the script-evaluator skill.
Score each dimension 1-10 and give specific fixes for anything below 7."
```

Also useful for comparing versions:
```
"Evaluate V1 and V2 side by side. Which is stronger and why?"
```

## Gotchas

- A high total with one dimension at 2 = video still feels broken. Fix the weakest link first.
- Choose the weakest relevant dimension from the brief and observed evidence; tension is not a universally established top predictor of engagement.
- Don't optimize "interesting" at the expense of truth or clarity. A confusing or exaggerated script is not an improvement.
- This evaluator works on: scripts, storyboards, Remotion TSX code, and even finished videos (describe what you see).

## Troubleshooting

- High creative score but unsupported claim: keep the score separate, identify the exact unsupported claim, and revise or remove that claim before calling the content ready for its requested use.
- No testimonials or numeric proof: do not penalize truthful copy into fabrication; evaluate supported examples and the intended audience instead.

## Source basis

- [FTC: advertisement endorsements](https://www.ftc.gov/news-events/topics/truth-advertising/advertisement-endorsements) — a testimonial cannot supply experience or substantiation that does not exist. Applied here as an evidence-preservation rule, not a legal-compliance certification.

Versions

RepositoryScoreLicence
This page · anastasiyaw/codex-claude-code-config100MIT
VanGong1999/screen-creative-skills100MIT

Database snapshot: 13.11.2026 · package version f934fbecdc55 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100video-narrative-arc
    Proven narrative arc templates for product videos and ads. Use when: 'write script', 'video structure', 'narrative arc', 'scene plan', 'storyboard', '15 second video', '30 second video', '60 second video', 'how to structure the video', 'video script template'. Provides…
  • 100product-meaning-extractor
    Deep product analysis before creating videos, presentations, or ads. Use when: 'analyze product', 'extract value', 'product brief', 'what makes this product special', 'prepare brief', 'understand the product', 'video brief'. Takes a URL or product description and outputs a…
  • 95video-marketing
    When the user wants to plan video marketing, create video scripts, or optimize for short-form or long-form video. Also use when the user mentions "video marketing," "video script," "short-form video," "long-form video," "TikTok script," "Reels script," "YouTube script," "video…
  • 100reel-panel
    Send an 11-agent review panel to watch a video (reel, short, ad, film) and rate it - hook, pacing, retention, sound, visuals, story, CTA - each panelist from a different viewer or craft angle, then merge the scores into one ranked fix list. Use when the user asks to rate,…
  • 100video-marketing
    When the user wants to plan video marketing, create video scripts, or optimize for short-form or long-form video. Also use when the user mentions "video marketing," "video script," "short-form video," "long-form video," "TikTok script," "Reels script," "YouTube script," "video…
  • 100video-director
    Run a whole explainer video from the user's script to an upload-ready MP4 — beat map, story arc, pacing check, style check, scene build, draft render, final render, mix and delivery — with approval gates so nothing expensive is rendered before the user has agreed. Uses the…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.