JasonColapietro/suede-creator-skills / skills/suede-social
suede-social
VerifiedPlan, audit, and draft organic social for founder/brand accounts: platform mix, 30-post audits, calendars, Instagram, LinkedIn/X, short-video scripts, social search, and listening. Use when asked to "audit our Instagram growth" or build an approval-ready content loop. NOT FOR: paid ads (use suede-ads or suede-ad-creative), editorial agents (use suede-newsroom), clip-to-guide work (use suede-clip-to-guide), video rendering (use suede-video), or broad content strategy (use suede-content-strategy).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 4.6 KB |
| SKILL.md | skill md | 14.2 KB |
| agents/openai.yaml | config | 643 B |
| evals/evals.json | config | 12.2 KB |
| references/account-audit.md | markdown | 5.2 KB |
| references/carousel-frameworks.md | markdown | 10.4 KB |
| references/content-production.md | markdown | 3.3 KB |
| references/daily-loop.md | markdown | 2.9 KB |
| references/listening-sources-template.md | markdown | 3.9 KB |
| references/listening.md | markdown | 12.8 KB |
| references/measurement.md | markdown | 2.8 KB |
| references/platform-limits.md | markdown | 3.0 KB |
| references/platforms.md | markdown | 7.0 KB |
| references/post-templates.md | markdown | 3.8 KB |
| references/reverse-engineering.md | markdown | 6.4 KB |
| references/short-form-video.md | markdown | 8.6 KB |
| references/social-search.md | markdown | 3.4 KB |
| references/worked-handoff.md | markdown | 1.7 KB |
references/short-form-video.md
View on GitHub# Short-Form Video: Hooks, Scripts & Strategy
Detailed reference for creating short-form video content on TikTok, Instagram Reels, and YouTube Shorts.
---
## Video Hook Library
### Curiosity Hooks (engagement hypothesis)
**The "Secret" Formula:**
- "The secret to [outcome] that nobody talks about"
- "I found the overlooked feature in [product/platform] that changes everything"
- "I can't believe this actually works..."
**The Unexpected Discovery:**
- "I tried [thing] for 30 days and I was NOT expecting this"
- "This completely changed how I think about [topic]"
- "Nobody talks about this, but..."
**The Question:**
- "Why does nobody talk about this?"
- "Am I the only one who didn't know this?"
- "The reason [common thing] doesn't work is..."
### Value Hooks (save-intent hypothesis)
**The Promise:**
- "How to [achieve outcome] in [specific timeframe]"
- "[Number] [things] that will [benefit]"
- "Everything you need to know about [topic] in 60 seconds"
**The Hack/Shortcut:**
- "[Outcome] hack that actually works"
- "The [adjective] way to [outcome]"
- "If you're struggling with [problem], watch this"
**The Warning:**
- "Stop doing [common practice]: here's why"
- "[Number] mistakes that are killing your [results]"
- "Why [thing you think is good] is actually hurting you"
### Story Hooks (retention hypothesis)
**The Transformation:**
- "3 months ago, I [bad state]. Today, I [good state]."
- "Here's how I went from [before] to [after]"
- "I used to think [old belief]. Then [event] changed everything."
**The Failure:**
- "I made a huge mistake with [topic]"
- "Here's why I stopped [common practice]"
- "I lost [something significant] because of this mistake"
**The Journey:**
- "So this just happened..."
- "This changed everything for me"
- "Let me tell you about the time I [interesting situation]"
### Contrarian Hooks (response hypothesis)
- "Unpopular opinion: [bold statement]"
- "[Common advice] is actually wrong"
- "I'm going to get hate for this, but..."
- "Most [audience] get this completely wrong"
---
## Scripting Template
```markdown
## Video: [Working Title]
**Platform:** TikTok / Reels / Shorts
**Length:** XX seconds
**Format:** [Talking head / Slideshow / Demo / Screen recording]
### Hook (0-3 sec)
- Visual: [What viewer sees]
- Audio: [What they hear]
- Text overlay: [On-screen text]
### Body (3-X sec)
- [Timestamp] - [What happens/what you say]
- [Timestamp] - [Next beat]
- [Continue...]
### CTA (final 3-5 sec)
- Verbal: [What you say]
- Text: [On-screen text]
- Action: [Follow, comment, link in bio, etc.]
### Production Notes
- Music/sound: [Trending sound or music choice]
- B-roll needed: [List any clips needed]
- Graphics: [Any text animations or overlays]
```
---
## Video Structures
These five beat sheets are the full set. Pick one before scripting, then test
the opening against the account's comparable-format retention baseline.
### Problem-Solution (15-30 sec)
```
[0-3s] Hook: State the problem
[3-10s] Agitate: Why it matters
[10-25s] Solution: Your method/product/tip
[25-30s] CTA: What to do next
```
Starting fit hypothesis: a single objection, a demo, a fix with visible proof
### List Format (30-60 sec)
```
[0-3s] Hook: "X things that [outcome]"
[3-50s] Items: One every 5-8 seconds
[50-60s] CTA
```
Starting fit hypothesis: save-intent content, checklists, roundups
### Tutorial (30-60 sec)
```
[0-3s] Hook: Show the end result first
[3-8s] Overview: "Here's how..."
[8-50s] Steps: Quick, clear instructions
[50-60s] Result + CTA
```
Starting fit hypothesis: process reveals, software walkthroughs, how-tos
### The Story Arc (45-60 sec)
```
[0-3s] Hook: Tease the outcome
[3-15s] Setup: Context and stakes
[15-45s] Journey: What happened
[45-55s] Resolution: The result
[55-60s] Lesson/CTA
```
Starting fit hypothesis: personal stories, case studies, testimonials
### The POV/Skit (15-30 sec)
```
[0-3s] Setup: Text overlay sets the scene
[3-25s] Performance: Act out the relatable scenario
[25-30s] Punchline or twist
```
Starting fit hypothesis: relatable content, humor, niche communities
---
## Caption & Subtitle Spec
Use captions as an accessibility and comprehension default. Treat any watch-time
lift or sound-off viewing rate as account-specific: verify it with current
retention and audio metrics where the platform exposes them.
- **MAX 2 lines** on screen at once
- **3-5 words per line**
- Bold, sans-serif font with black outline
- **Highlight key words** in a different color
- Match timing to speech exactly
Caption tooling, export specs, and edit execution belong to `suede-video`.
---
## Visual Patterns
### Talking Head
- Good lighting (ring light or window light)
- Eye contact with camera
- Hand gestures for emphasis
- Interesting background (bookshelf, plants, studio setup)
### Slideshow/Carousel Video
- Test 2–4 seconds per slide as a starting range, then adjust from retention
- Text overlays with key points
- Consistent style/branding
- Voiceover or trending sound
### Screen Recording
- Zoom in on important areas
- Add cursor highlight or click animations
- Keep movements smooth and intentional
- Overlay your face in corner (optional but boosts engagement)
### B-Roll Heavy
- Show don't tell
- Test 1–3 seconds per shot as a starting range, then adjust from retention and
comprehension
- Match cuts to voiceover beats
- Mix wide, medium, and close-up shots
---
## Audio Strategy
### When to Use Trending Sounds
- Entertainment/lifestyle content where the sound fits your message
- When the trend is still rising (check platform trending pages)
- Don't use when it distracts from your message or is already declining
### When to Use Original Audio
- Educational content where you're speaking
- Storytimes and personal narratives
- Product demos and tutorials
- Building a recognizable brand voice
### Voiceover Tips
- Speak slightly faster than normal conversation
- Vary your tone: avoid monotone delivery
- Pause for emphasis on key points
- Record in a quiet space, use noise removal
- AI voices work for faceless content (ElevenLabs, etc.)
### Music Selection
- Match energy to content (upbeat for tips, emotional for stories)
- Avoid copyrighted music on Reels/Shorts
- Use platform music libraries for safety
- Lower music volume under voiceover (ducking)
---
## Posting Strategy
### Timing hypotheses
Use current follower-activity data and official platform guidance when
available. If they are unavailable, rotate comparable posts through three
audience-local starting windows: morning (7–10), midday (11–14), and evening
(18–21), for a bounded four-week test. These are test bins, not best times.
### Cadence hypotheses
| Goal | Starting Test | Decision Rule |
|------|---------------|---------------|
| Build a baseline | 3–5 posts per week for four weeks | Keep only if quality and production capacity hold |
| Maintain presence | 2–3 posts per week for four weeks | Compare reach and downstream actions with prior period |
| Test a format | 4–6 comparable posts across two weeks | Change one format variable and compare with account baseline |
Adjust the range to the account's current cadence, source volume, and review
capacity. More posts are not automatically better.
### Batch Creation Workflow
1. **Ideate** (30 min): Generate 10-20 concepts
2. **Script** (1 hour): Write scripts for 5-10 videos
3. **Batch film** (2 hours): Record all talking head content
4. **Edit** (2-3 hours): Edit and add captions
5. **Schedule** (planning estimate: 15–45 min): queue the approved timing-test
cells and record the hypothesis
---
## Analytics & Iteration
### Metrics That Matter
| Metric | What It Tells You |
|--------|-------------------|
| Watch time % | Is content engaging throughout? |
| Completion rate | Did hook + content deliver? |
| Saves | Is content valuable enough to revisit? |
| Shares | Is content worth spreading? |
| Comments | Did content spark conversation? |
| Follows | Did viewer want more from you? |
### What to Test
1. **Hooks**: Same content, different opening
2. **Length**: 15 sec vs 30 sec vs 60 sec
3. **Format**: Talking head vs slideshow vs demo
4. **Time**: Morning vs afternoon vs evening
5. **CTA**: Different calls to action
### When to Pivot
- After a bounded cohort, if completion or retention is materially below the
account's trailing comparable-format baseline, test a different opening.
- If reach is high but qualified follows or downstream actions are low, inspect
CTA and audience fit.
- If saves and shares diverge, treat that as a format clue to investigate, not
a universal content diagnosis.
- If comments are negative, classify the objections and safety risk; do not
manufacture controversy for distribution.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |