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/platform-rules.md
View on GitHub# Platform Rules: Algorithms, Retention Targets & Safe Zones
Each network ranks content on a distinct set of signals. Optimize for the platform you're writing for — a script tuned for TikTok loop rate is not tuned for X reply weight.
## Contents
- Per-platform algorithm rules
- Retention / engagement targets (the numbers to hit)
- Realistic benchmarks for new accounts
- Video safe zones (pixel-exact)
---
## Per-platform algorithm rules
### YouTube Shorts
- Three-phase seeding pipeline: tests on a small group, then matches high performers to broader topic clusters.
- **Absolute watch time and completed views** are now the primary ranking signals (they replaced simple swipe-away rate).
- Autoplay previews play the first **1–2 seconds without sound** on hover → the opening _visual_ hook is what earns the click.
- Longer Shorts generate more total watch time, so **30–45s videos are favored over 15s clips**, provided they clear ~50–65% average percentage viewed.
### TikTok
- Pure interest graph: every video is tested on a small audience by metadata, visual signals, and audio. **Follower count barely affects initial distribution.**
- Prioritizes **completion rate, direct shares, and loop rate.**
- Creator Rewards Program enforces a **60-second minimum** — structure those scripts carefully to hold retention over the longer runtime.
### Instagram Reels
- Integrated with Meta's social graph; prioritizes **DM shares and saves over likes.**
- Rewards content that sparks private conversations (DM forwards), the existing creator–viewer relationship, and **trending audio** for new-audience reach.
### Twitter / X
- Open-source recommendation algorithm using weighted scores in the "For You" feed; rewards **interactive conversation** over passive views.
- Groups users into **SimClusters** (shared-interest communities) and amplifies posts with deep engagement inside a cluster before expanding to adjacent ones.
---
## Retention / engagement targets
| Metric | How it's measured | Viral-reach target | Primary distribution trigger |
| ----------------------- | ------------------------- | --------------------------- | ------------------------------ |
| Shorts retention (<30s) | Average % viewed | **≥ 65%** avg view duration | high-retention watch-time gate |
| Shorts retention (>30s) | Average % viewed | **≥ 50%** avg view duration | high-retention watch-time gate |
| TikTok loop rate | Complete-rewatch rate | **35–50%** completion | completion rate & watch time |
| Reels engagement | Saves + DM shares ÷ views | **30–40%** completion | DM shares & saves |
| X reply | 9.0× training weight | high reply-to-view ratio | conversation & thread depth |
| X retweet | 1.0× training weight | stable share-to-like ratio | standalone value |
| X like | 1.0× training weight | broad endorsement | emotional resonance |
**Implication for X:** a reply is worth ~9× a like in the ranking model — write posts that _invite a response_ (a question, a take to argue with), not just a nod.
---
## Realistic benchmarks for new accounts
Measure against platform averages, not viral outliers. Per a Metricool analysis of ~82,000 accounts, the global average across all YouTube videos (Shorts + long-form) is ~**687 views.**
Expected-view bands by subscriber tier:
```
< 1,000 subs → 50–500 views
1,000–10,000 subs → 200–2,000 views
10,000–100,000 subs → 1,000–10,000 views
```
Short-form distribution is meritocratic: each video is judged on its own retention, so a new channel can outperform an established one by delivering exceptional retention on a single video. Set expectations here — don't promise virality.
---
## Video safe zones (1080 × 1920 vertical canvas)
Keep all text overlays, logos, faces, and CTAs inside the safe container so native UI doesn't cover them. Specify placement in the scenario.
| Platform | Top unsafe | Bottom unsafe | Side unsafe | Safe container |
| ------------------- | -------------------------- | -------------------------- | ---------------- | -------------------------------------------------- |
| **Instagram Reels** | 108 px (profile/feed crop) | 320 px (captions/comments) | L 60 / R 120 px | central **840 × 1350** box |
| **YouTube Shorts** | 380 px (search bar/UI) | 380 px (interaction bar) | L 60 / R 120 px | central **840 × 1160** box (slightly left-shifted) |
| **TikTok** | 160 px (search/tabs) | 480 px (description/icons) | L 120 / R 120 px | central **840 × 1280** box |
Rule of thumb: TikTok has the most aggressive bottom UI (480 px) — keep captions higher; Reels' bottom 320 px eats lower-thirds; Shorts crops both ends hard. When in doubt, keep critical text vertically centered.
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 |