> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videngineer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reading Script Analysis

> What every diagnostic field in script_analysis means and how to use it.

Reading Script Analysis answers: **which script fields should I trust, and how do I turn them into decisions?**

Every completed teardown includes a Script tab. This page explains its diagnostic fields. For the structural side - hook, re-hooks, beat sheet, CTAs, phrases, and voice-over - see the [Script analysis layer reference](/layers/script-analysis).

## Hook score (0-100)

A composite score for how hard the opening earns attention.

| Range    | What it means                                                                         |
| -------- | ------------------------------------------------------------------------------------- |
| 75-100   | Hook is doing real work: curiosity gap, identity signal, or pattern interrupt present |
| 50-74    | Serviceable hook: clear opening, but missing a sharp pull mechanism                   |
| Below 50 | Weak hook: relies on existing audience loyalty; cold audiences may scroll             |

**How to use:** If a reference scores 80+, study the hook structure carefully. If it scores below 55 and still has high reach, distribution may be doing the work the hook is not. Do not borrow that exact hook; study the distribution context instead.

## Emotional arc

The emotional journey the viewer is taken through.

| Arc                          | Structure                                           | Best for                           |
| ---------------------------- | --------------------------------------------------- | ---------------------------------- |
| `pain -> relief`             | Problem shown first, solution resolved at end       | Products that fix something broken |
| `aspiration -> pathway`      | Desire established, roadmap given, belief installed | Education and coaching             |
| `curiosity -> reveal`        | Question opened, answer withheld, payoff at end     | Entertainment and explainers       |
| `identity -> belonging`      | "People like you do this" frame                     | Community and brand content        |
| `social proof -> invitation` | Others won, now it is your turn                     | Testimonial-driven ads             |

**How to use:** Pick the arc that matches your offer, not necessarily the one the reference used. If the arc does not fit your product, the conversion logic will feel wrong.

## Pacing type

How the edit rhythm is structured across the video.

| Value          | Meaning                                        | Typical use                               |
| -------------- | ---------------------------------------------- | ----------------------------------------- |
| `accelerating` | Cuts get faster toward the CTA                 | Short-form ads, direct response           |
| `even`         | Consistent rhythm throughout                   | Educational explainers, tutorials         |
| `frontloaded`  | Fast early to hook, slower middle, tight close | YouTube hybrid content                    |
| `decelerating` | Starts fast, slows into the close              | Long-form content with a reflective close |

**How to use:** Match your edit pacing to the arc. An accelerating pace on a pain-to-relief arc is classic direct response. An even pace on an aspiration-to-pathway arc feels more educational.

## Virality signals

Structural elements that correlate with sharing behavior. They are not guarantees; they are patterns observed in high-performing content.

Common signals:

* `identity_claim` - "If you are a \[X]..." triggers self-identification
* `social_proof_reference` - named companies, user counts, specific outcomes
* `unexpected_reframe` - flips a familiar idea
* `loop_worthy_ending` - prompts a rewatch to catch something missed
* `comment_bait_phrasing` - invites debate or personal sharing
* `scroll_stop_visual` - face, text card, or dramatic visual that interrupts browsing

**How to use:** If a video has 3+ signals and strong reach, those signals may be contributing. Add the same kinds of signals only where they fit naturally.

## Content patterns

The repeating structural moves inside the video - its skeleton.

```text theme={null}
frustration -> what-if pivot -> demo -> social proof -> CTA
claim -> counter-argument -> resolution -> repeat x3 -> CTA
problem stated -> micro-story -> proof point -> repeat x2 -> invitation
hook -> education block -> case study -> education block -> close
```

**How to use:** Lift the skeleton, replace the content. If the pattern is `problem stated -> micro-story -> proof point -> CTA` and you have three proof points, you already have three scenes structured.

## Supporting fields

**Transcript** - Full transcript in `[MM:SS] line` format. Use it to see where hook, body, and CTA begin and end.

**Voice analysis** - Gender, age range, accent, tone, pace, words per minute, and cadence. Useful for casting and recording direction.

**Audio analysis** - Speech percentage, silence percentage, and whether music is present. High silence percentage in a performing video is often deliberate.

## Next steps

<CardGroup cols={2}>
  <Card title="Script analysis layer" icon="chart-line" href="/layers/script-analysis">
    The 7-element skeleton behind these diagnostics.
  </Card>

  <Card title="Hooks & re-hooks" icon="anchor" href="/layers/hooks">
    Hook types, strength, and re-hook cadence in depth.
  </Card>

  <Card title="Scene prompts" icon="image" href="/scriptwriters/recreation-prompts">
    Turn the visual blueprint into scene and cut-level direction.
  </Card>

  <Card title="Teardown to your video" icon="arrow-right" href="/scriptwriters/teardown-to-video">
    Full workflow with the script brief template.
  </Card>
</CardGroup>
