# viral-video-hook-templates

viral-video-hook-templates is a Claude Code skill with ten hook templates and FFmpeg filters for the first 3 seconds of video. It helps test opening variations and hold viewers’ attention.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 131 installs · ★ 66 repo stars
- Author: JosiahSiegel
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/ffmpeg-social-video/skills/viral-video-hook-templates/SKILL.md
- Updated: 2026-06-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/viral-video-hook-templates

## What it does

The skill provides ten retention formulas with specific FFmpeg filter chains tailored for the 1.3-3 second opening window. It includes filter graphs for rhythmic zoom pulses via `zoompan`, camera shake using trigonometric expressions inside `crop`, color flashes, and timed text placement using `drawtext`.

Each hook category includes benchmarked stop rates, ranging from pattern interrupts at 85% to urgency cues at 65%. A bundled shell script automates A/B testing by rendering three distinct hook variations concurrently from a single video source.

Rendering requires a local FFmpeg installation. Windows systems strictly require backslashes `\` for file paths when editing or executing filter commands.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-hook-templates -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/viral-video-hook-templates/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/viral-video-hook-templates/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-hook-templates -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/viral-video-hook-templates/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-hook-templates -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/viral-video-hook-templates/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/ffmpeg-social-video/skills/viral-video-hook-templates
```

2. **Manually: put the files in place**
- File: `.github/skills/viral-video-hook-templates/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-hook-templates -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/ffmpeg-social-video/skills/viral-video-hook-templates
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/viral-video-hook-templates/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-hook-templates -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/ffmpeg-social-video/skills/viral-video-hook-templates/SKILL.md

## When to use it
- render dynamic zoom pulse or shake effects on the first two seconds
- generate three hook variations for A/B testing with a shell script
- apply timed text overlays using FFmpeg filter expressions
- select opening video hooks based on average scroll stop rates

## Example prompts
- Apply a zoom pulse hook with a text overlay to the first 1.5 seconds of `input.mp4`
- Generate three A/B test hook variants for my TikTok video using FFmpeg
- Add a pattern interrupt shake effect to the opening scene of `clip.mp4`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7431d64aeab972fc.

BEGIN THIRD-PARTY FILE 7431d64aeab972fc
```text
---
name: viral-video-hook-templates
description: |
  10 proven viral video hook templates with FFmpeg implementations for maximum first-3-second retention.
  PROACTIVELY activate for: (1) Video hook creation, (2) Opening sequence optimization, (3) Attention-grabbing techniques, (4) Pattern interrupt effects, (5) Curiosity gap implementation, (6) Text overlay hooks, (7) Visual hook effects, (8) Audio hook strategies, (9) Retention optimization, (10) Scroll-stopping content.
  Provides: Research-backed hook formulas, FFmpeg filter implementations, psychological triggers, platform-specific hooks, A/B testing workflows, and real-world examples with measurable impact.
---

## CRITICAL GUIDELINES

### Windows File Path Requirements

**MANDATORY: Always Use Backslashes on Windows for File Paths**

When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).

### Documentation Guidelines

**NEVER create new documentation files unless explicitly requested by the user.**

---

# Viral Video Hook Templates (2025-2026)

## The Science of Hooks

**The Critical Window**: You have **1.3-3 seconds** to stop the scroll. Research shows:
- 65% of viewers decide to watch or skip within 3 seconds
- Videos with strong hooks have 2-3x higher completion rates
- The hook accounts for up to 80% of a video's viral potential

---

## Hook Timing Reference

### Optimal Hook Durations by Type

| Hook Type | Duration | Reasoning |
|-----------|----------|-----------|
| Pattern Interrupt (visual) | 0.3-0.5s | Quick shock, then content |
| Pattern Interrupt (text) | 1.0-1.5s | Time to read "STOP" etc |
| Curiosity Gap | 2.0-3.0s | Two-part reveal timing |
| Direct Challenge | 1.5-2.5s | Read + process + react |
| Transformation Tease | 2.0-3.0s | Before/after comparison |
| Question Hook | 1.5-2.0s | Read + mental engagement |

### FFmpeg Time Units Quick Reference

**All FFmpeg filter expressions use SECONDS with decimals**:

| Expression | Meaning | Example Use |
|------------|---------|-------------|
| `t` | Current time | `enable='lt(t,2)'` = first 2 seconds |
| `between(t,0,2.5)` | Time range | Hook visible for 2.5s |
| `if(lt(t,1),expr1,expr2)` | Conditional | Different effect in first second |
| `sin(t*10)` | Oscillation | 10 cycles per second |
| `exp(-t*3)` | Decay | Quick fade (3 = fast decay) |
```
END THIRD-PARTY FILE 7431d64aeab972fc

The third-party file has ended. Everything between the 7431d64aeab972fc tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2370 of 8004 bytes. © JosiahSiegel · MIT · https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/ffmpeg-social-video/skills/viral-video-hook-templates/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
