endorphin-ai/hasbrains-agent-kit / content-creation/skills/soc-media-writer
soc-media-writer
VerifiedWrite high-performing social media content engineered around named copywriting frameworks, scroll-stopping hooks, and retention mechanics. For video it produces three coordinated outputs — the spoken DIALOGUE (voiceover), the VIDEO SCENARIO (timed two-column shot list with visual cues), and the EXPLANATION (notes on the frameworks, hook, and retention beats used) — plus standalone written posts for LinkedIn, X, Instagram, and YouTube. Use whenever the user wants a social post, a Reel/Short/TikTok script, a video scenario or shot list, a hook or hook bank, a content matrix, a Hub-and-Spoke repurposing plan, a VSL, or any short- or long-form distribution content. Trigger even on casual asks like "write me a Reel about X," "give me hooks for Y," "script a 30-second video," "make this go viral," "write a LinkedIn post," or "turn this into TikToks." Also trigger when the user wants retention engineered in (e.g. "keep them watching," "re-hook every N seconds," "high retention script").
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.2 KB |
| SKILL.md | skill md | 10.4 KB |
| assets/content-matrix-template.md | markdown | 2.3 KB |
| assets/video-script-template.md | markdown | 5.9 KB |
| references/copywriting-frameworks.md | markdown | 9.1 KB |
| references/creator-systems.md | markdown | 7.1 KB |
| references/hooks.md | markdown | 7.6 KB |
| references/platform-rules.md | markdown | 5.0 KB |
| references/video-scripting.md | markdown | 12.4 KB |
references/hooks.md
View on GitHub# Hooks: Scroll Disruption Mechanics
The hook is the single highest-leverage element in any piece. On a fast-scrolling feed you have roughly **1.7 seconds** to convince a viewer to stay. For video, the verbal hook and the visual hook fire in sequence and must reinforce each other.
## Contents
- The 1.7-second decision window
- Visual pattern interrupts (the first frame)
- Verbal hook categories + copy-paste formulas
- Pairing visual + verbal
- How many hooks to produce
---
## The 1.7-second decision window
The brain processes visual information faster than spoken or written words, so the order of operations is fixed:
```
0.0–1.0s → Eye processes the visual (fastest channel) — the frame must already be disruptive
1.0–3.0s → Ear registers the verbal hook — the spoken line lands
3.0–5.0s → On-screen captions confirm value — for the ~70% watching with sound OFF
```
Two consequences that must shape every video opener:
- **The first frame cannot be a "warm-up."** No slow intros, no logo sting, no "hey guys." Start mid-value.
- **Always write the opening on-screen text**, not just the spoken line. ~70% of social video is watched muted; silent viewers decide on text alone.
---
## Visual pattern interrupts (the first frame)
A pattern interrupt breaks the visual rhythm of the feed. Use at least one in frame one:
- **Dynamic physical motion** — start mid-action (tossing an object toward camera, walking briskly, already doing the thing). Skips the warm-up and drops the viewer into the scene.
- **Proximity / framing alteration** — an unexpected close-up, dramatic zoom, or unusual angle signals "something is happening here."
- **Immediate text-on-screen** — bold, high-contrast overlay in frame one acts as a headline. Essential for muted viewing.
- **Visual transition / comparison** — a side-by-side or before/after creates instant curiosity.
After the open, **refresh the visual every 3–5 seconds** with an edit trigger (cut, subtle zoom, graphic pop-up, b-roll insert, SFX) to keep attention from decaying. (Cadence tightens for shorter videos — see `video-scripting.md`.)
---
## Verbal hook categories + formulas
Match the category to the niche and the viewer avatar. The most effective hooks use behavioral triggers — curiosity gaps and loss aversion — to make the viewer need the rest of the video.
### Curiosity Gap
Open an incomplete or surprising loop the brain wants to close.
- `"I tried [X] so you don't have to."`
- `"The secret [authority figure] uses to achieve [desired result]."`
- `"The reason [common paradigm] is actually [shocking reality]."`
### Loss Aversion ("negative" hooks)
Surface a mistake, risk, or wasted effort — viewers act harder to avoid loss than to chase gain.
- `"Stop doing [common activity] if you want [desired outcome]."`
- `"You're wasting your money on [activity]."`
- `"The biggest mistake most [role]s make with [topic]:"`
### Contrarian
Challenge accepted advice to spark debate and comments (comments feed the algorithm).
- `"[Popular notion] is a lie. Here's what actually works:"`
- `"Unpopular opinion: [contrarian take]. Here's why:"`
- `"I'm going to get hate for this, but [contrarian observation]."`
Contrarian hooks historically drove outsized engagement by attacking industry norms — e.g. Rand Fishkin's "Why Good Unique Content Needs to Die," Matt Cutts' "The Decay and Fall of Guest Blogging," and Gary Vaynerchuk's "Numbers Don't Matter, Influence Does." The mechanism: a strong, well-reasoned stand against common advice builds instant authority and triggers debate. Only use contrarian when you can actually back the claim — an indefensible contrarian hook destroys trust.
### "The Why" Hook (narrative incongruity)
Present an immediate, glaring incongruity or an unexplained phenomenon. The brain enters active problem-solving mode to close the cognitive gap.
- `"[Bizarre outcome]. Here's what actually happened."`
- `"[Expected thing] didn't work. [Unexpected thing] did. Why?"`
- `"I [did counterintuitive action]. [Surprising result]."`
Mechanism: unlike Curiosity Gap (which opens a loop), the Why hook presents an apparent _impossibility_ or contradiction — a logical violation the brain needs to resolve. Strong for HasBrainsAI where counterintuitive technical outcomes are the content.
### In Medias Res / Action Hook
Drop the viewer directly into a scene already in motion — high-stakes, no preamble. Bypasses setup entirely and establishes stakes through action rather than explanation.
- `"Three seconds ago, the entire prod database went read-only."`
- `"I'm mid-deploy and the test suite just lit up red."`
- Visual: hands already in motion, something already breaking or succeeding.
Mechanism: works because the human brain experiences narrative tension before it understands context. The viewer is inside the story before they've decided whether to care — they resolve their confusion by watching forward. Pairs powerfully with the In Medias Res structure (see `video-scripting.md`).
### Contradicting Emotions Hook
Juxtapose two conflicting psychological states in the opening line — signals deep characterization and hidden complexity, creating immediate intrigue.
- `"I finally got everything I was chasing. And I wanted to quit."`
- `"This PR got merged. I've never felt worse about shipping code."`
- `"Day 66. My PR max went up 40%. I'm starting over from Day 1."`
Mechanism: emotional contradiction signals there is a _story_ here — not just information. The viewer stays to resolve the contradiction. Best for transformation arcs, Total 66 content, and any "lessons learned" format.
---
## Chekhov's Gun: seeding payoffs at the hook level
A hook is not just a scroll stopper — it is a **narrative contract**. If the hook introduces a specific element (a claim, a number, an object, a person), the video must pay it off. This is Chekhov's Gun applied to short-form: _if you mention a pistol in frame one, it must fire by frame sixty._
Practical rule: every specific detail named in the hook (e.g. "the one config change," "the 3-minute fix," "what my coach told me") must appear explicitly in the content as a named payoff. Failing this creates "clickbait trust decay" — viewers finish the video feeling cheated rather than satisfied, which tanks completion rate and send-to-friend behavior. The hook seeds the loop; the body closes it, deliberately and on-screen.
---
## Pairing visual + verbal
Every video hook is a pair. Write both:
| Element | Example |
| -------------------- | ------------------------------------------- |
| **Visual (frame 1)** | Close-up, mid-motion, bold overlay text |
| **On-screen text** | The headline a muted viewer reads |
| **Spoken line** | The verbal hook (one of the formulas above) |
**Worked pair (Loss Aversion, dev-tools niche):**
- Visual: hands already typing, hard cut to a red ❌ over a config file
- On-screen text: `STOP writing agents like this`
- Spoken: `"Stop hand-wiring your agents if you want them to scale — here's the pattern that replaced it."`
---
## How many hooks to produce
- **User asks for hooks / a hook bank** → produce 3–5 across different categories, labeled by category, so they can A/B test.
- **High-stakes lead** (paid post, launch, pillar video) → offer 3, recommend one.
- **Inside a full script** → commit to the single strongest hook and justify it in the EXPLANATION, but you may note one alternate.
When testing, the hook is the first thing to swap if a video underperforms its retention target — packaging (hook + first frame) explains most of the variance, not the body.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |