hook-storyboard-retention

Write hooks, retention plans, and beat-by-beat storyboards for short-form video scripts.

1|Updated Aug 7, 2026
One-click install
npx skills add https://github.com/Deepak-ai-93/deepak-skill --skill hook-storyboard-retention-deepak-ai-93
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-storyboard-retention
Source: https://github.com/Deepak-ai-93/deepak-skill/tree/main/skills/hook-storyboard-retention
Command: npx skills add https://github.com/Deepak-ai-93/deepak-skill --skill hook-storyboard-retention-deepak-ai-93

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Short-form videos lose most viewers in the first seconds, and scripts written separately from the video timeline drift out of sync. This Skill produces scroll-stopping hook copy, retention-engineered beat sheets, and storyboards where every script clause maps to a timed visual beat for Instagram Reels, TikTok, and YouTube Shorts. ## Core Features & Use Cases - Hook copywriting formulas: Five proven templates (curiosity gap, contrarian, results-first, specific number, pain point) with rules for first-frame text and mute-first viewing. - Retention engineering: Diagnoses drop-off patterns (the Cliff, the Hump, the Plateau) and applies pacing density, open loops, pattern interrupts, and loop endings. - Script-to-timeline sync: Generates dual-column storyboards where each 3-5 word script block maps to a HyperFrames clip with matching data-start/data-duration attributes and GSAP timeline positions. - Automated audit harness: Runs audit-storyboard.mjs to check hook placement, beat structure, sync contracts, and render determinism, then a fresh auditor subagent scores the storyboard out of 50 before delivery. - Use Case: A creator planning a 30-second finance reel uses the Skill to pick a contrarian hook, build a 5-beat storyboard with timed text overlays, and validate it with the audit harness before rendering. ## Quick Start Ask the agent to write a hook and 30-second storyboard for your topic, for example: create a retention-optimized storyboard for a TikTok about three money rules nobody tells you.

Frequently Asked Questions about hook-storyboard-retention

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a hook for a TikTok or Instagram Reel?

Pick one of five hook formulas: curiosity gap, contrarian, results-first, specific number, or pain point. Write the hook as the first frame of text with no intro or greeting, and keep it under about 12 words so it lands within the first 3 seconds.

How do I keep viewers watching a short video to the end?

Apply retention engineering: change the visual every 1.5-2 seconds, open a loop in the hook and close it only in the final 3 seconds, add pattern interrupts where attention dips, and make the last frame mirror the first so rewatches count as views.

How do I sync a video script with the storyboard timeline?

Write the script in 3-5 word blocks and map each clause to one visual beat with matching data-start and data-duration attributes. The GSAP timeline position for each element must equal the storyboard timestamp so content and video stay one artifact.

Does the storyboard audit work without an HTML composition?

Yes, audit-storyboard.mjs audits storyboard.md alone, checking hook placement, beat structure, payoff, CTA, and retention devices. Without an HTML file it issues a WARN and skips the GSAP timeline and determinism checks.

Why does audit-storyboard.mjs fail on my video composition?

Common causes are a missing hook in the first 2 seconds, no window.__timelines.reel GSAP registration, Math.random() usage, or SMIL animate tags. Fix the flagged item and re-run the script until it exits 0 before submitting to the auditor subagent.