carousel-narratives
Use when writing a multi-slide carousel post for Instagram, LinkedIn, or similar — for any niche or business — including repurposing scripts/blogs into slides…
Use when diagnosing why a published video underperformed — reading a YouTube retention graph, comparing a weak video against a winner, or mapping audience drop-off points to script beats. For writing the next script, use storytelling-hooks or long-form-youtube.
$ npx -y skills add yaxeen/storytelling-skills --skill retention-audit --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/retention-auditContext preview
The summary Claude sees to decide when to auto-load this skill.
Use when diagnosing why a published video underperformed — reading a YouTube retention graph, comparing a weak video against a winner, or mapping audience drop-off points to script beats. For writing the next script, use storytelling-hooks or long-form-youtube.
name: retention-audit description: Use when diagnosing why a published video underperformed — reading a YouTube retention graph, comparing a weak video against a winner, or mapping audience drop-off points to script beats. For writing the next script, use storytelling-hooks or long-form-youtube.
| Zone | Where | Healthy sign | Failure means | |------|-------|--------------|---------------| | Cliff | 0:00–0:30 | ≥65–70% still watching | packaging↔opening mismatch (confirm-the-click failure) | | Intro | 0:30–2:00 | slope flattening | throat-clearing, promise not restated, stakes missing | | Body | 2:00–sag | tracks/above typical band; small spikes | a loop closed without opening the next; pacing monotone | | Sag | ~40–60% of runtime | a visible re-hook bump or held line | no planned re-hook; mid-video drift | | End | last 10% | gentle taper | fine unless a cliff — outro started too early |
1. **Overlay the comparison.** Note the winner-vs-loser gap at 0:30, 1:00, 2:00. If the gap is born in the first minute, the diagnosis is almost never "bad content." 2. **Check the click triangle.** Thumbnail promise vs title promise vs actual first frame/line. Any mismatch = the cliff's cause. (Winner channels show the *same world* in thumbnail and frame one.) 3. **Map drops to beats.** Put the script's beats on the timeline; for each visible dip, name the beat that was playing. Ask: did this beat close a loop without opening one? Sag without a re-hook? Tension the audience didn't come for? 4. **Check the channel formula.** Compare the flop's premise against the winners' shared pattern (subject type, resolution type, emotional promise) — use **channel-formula** to extract it if it isn't written down yet. A technically good story that breaks the channel's core promise still dies — audience expectation beats craft. 5. **Mark the spikes.** List rewatched moments and what structural move each used. 6. **Deliver findings** — for each: timestamp zone, what the graph shows, the script beat responsible, the cause, the fix. End with the single highest-leverage change for the next video, and feed the result back into the channel's profile (**channel-formula**) if one exists.
| Mistake | Fix | |---------|-----| | Judging by end-retention or AVD alone | Zone-by-zone against a winner — the cliff decides distribution | | Blaming the script for a 0:30 cliff | Check the click triangle first; the body may be healthy | | Ignoring spikes | Spikes are free R&D — codify what those beats did | | Auditing without a baseline | Same-channel winner first; typical band only as fallback | | One flop = change everything | Change the diagnosed zone only; keep what the graph says worked | | Findings without next-video actions | Every finding ends in a concrete instruction for the next script |
A suite of nine Claude Code skills that apply the same six psychology-based storytelling levers across every content format — short-form video, long-form YouTube, titles & thumbnails, carousels, email, and website wireframes — plus a post-publish loop that
Repo: yaxeen/storytelling-skills
Use when writing a multi-slide carousel post for Instagram, LinkedIn, or similar — for any niche or business — including repurposing scripts/blogs into slides…
Use when extracting a channel's winning content formula from its own performance data — comparing top videos against flops on any YouTube/TikTok/Instagram…
Use when writing email or newsletter subject lines, preview text, opening lines, or full emails (value newsletters, launches, outreach) for any niche or…
Use when writing, outlining, or structuring a long-form YouTube video script (roughly 6-25 minutes) for any niche or business, or when diagnosing a video that…
Use when writing any short-form video script, hook, opening line, or scroll-stopping content (TikTok, Reels, Shorts) for any niche or business — when the first…
Use when writing YouTube/video titles, designing thumbnail concepts, or diagnosing low click-through rate for any niche or business — whenever a title and…