Short-Form Video 3-Second Thumbstop Hook Benchmark
A bilingual set of illustrative short-form video hook examples, plus an offline retention-curve analyzer. No measured hook-performance benchmark is claimed.
Problem it addresses
Provide a small, expandable set of Arabic and English hook examples organized by category, an offline retention-curve analyzer, and a skill for drafting context-specific hooks. The included examples and retention fixtures are illustrative; they do not establish market performance.
Who it is for
BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.
What is inside
Key files listed in the README repository architecture:
data/video_hooks_300.json (currently 11 illustrative hooks; filename retained for compatibility)data/video_hooks_catalog.csvdocs/hook-psychology-breakdown.mdexamples/hook_testing_case_study.mdexamples/tiktok_retention_curve.csvLICENSEREADME.mdreports/retention_waterfall.htmlSKILL.mdsrc/retention_analyzer.pytests/test_retention.py
How to evaluate and use it
- Read the README first and confirm that the documented problem matches your use case.
- Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
- Follow the repository’s Quick Start and check prerequisites before running commands.
- Compare outputs with documented examples and review limitations before using them in a decision or client workflow.
Quick Start from the README: python -m unittest discover -s tests · python src/retention_analyzer.py --help
Scope and limitations
- 3-Second Thumbstop Metric: A user-supplied campaign metric: calculate it from the selected platform export and compare against that account’s own baseline. This repository provides no universal target or measured benchmark.
- Visual Pattern Interrupts: Audits presence of rapid visual motion, unexpected text overlays, or sound cues within the first 1.5 seconds.
- Dialectal Hook Examples: Includes illustrative openings such as 'أكبر غلطة...' and 'لو ساكن في الرياض...'; they are not represented as validated top performers.
This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.