/social-media-writer

name: social-media-writer
description: |
  Creates engaging social media content for LinkedIn, Twitter/X, Instagram, and other platforms.
  Uses proven hook formulas, platform-specific best practices, and learns from reference examples.
  Generates posts, carousels content, thread scripts, and engagement content. Use this skill
  for any social media content creation needs.
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
  - Grep
  - AskUserQuestion

Social Media Writer Skill

> **QUICK REFERENCE** > - **LinkedIn output**: `output/content/social/linkedin/` > - **Twitter output**: `output/content/social/twitter/` > - **Instagram output**: `output/content/social/instagram/` > - **Naming**: `YYYY-MM-DD_topic_platform.md` > - **Sample script**: `scripts/samples/sample_social_content.py` > - **Check references first**: `references/examples/social/`

Expert social media content creation for engagement and growth across platforms.

Scope of This Skill

**This skill handles:**

• LinkedIn posts and articles
• Twitter/X posts and threads
• Instagram captions
• Facebook posts
• Carousel content (text for slides)
• Thread scripts
• Hashtag strategies
• Engagement content
• Repurposed content for social

**NOT handled by this skill:**

• Creating visual designs → Use `local-pptx-editor` or design tools
• Scheduling posts → Creates content only
• Analytics → Creates content only

Platform Specifications

LinkedIn

**Optimal Post Structure:**

[HOOK - First 3 lines visible before "see more"]

[VALUE - Main content, insights, story]

[CTA - Engagement question or action]

[HASHTAGS - 3-5 relevant]

**Best Practices:**

• Character limit: 3,000 (optimal: 1,200-1,500)
• First 3 lines are critical (before "see more")
• White space increases readability (+25% engagement)
• Carousels/PDFs get highest dwell time
• Best times: Tue-Thu, 8-11 AM
• Comments > Likes (15x more valuable)

Twitter/X

**Optimal Structure:**

[HOOK - Pattern interrupt or bold statement]

[BODY - Value or insight]

[CTA - Engage or follow action]

**Thread Structure:**

1/ [Hook that earns the click]

2/ [Context or background]

3-8/ [Main points, one per tweet]

9/ [Summary or key takeaway]

10/ [CTA + thread link]

**Best Practices:**

• Single tweet: 280 characters (optimal: 100-150)
• Threads: 5-12 tweets optimal
• No links in first tweet (kills reach)
• Hashtags: 1-2 maximum
• Best times: 8-10 AM, 12-1 PM

Instagram

**Caption Structure:**

[HOOK - Stop the scroll]

[BODY - Story or value]

[CTA - Engagement action]

.
.
.

[HASHTAGS - 5-15 in separate block]

**Best Practices:**

• Character limit: 2,200 (optimal: 150-300)
• First line must hook
• Emojis: Yes, but strategic
• Hashtags: Mix popular + niche
• CTA: Ask questions, save prompts

Hook Formulas

Opening Hook Types

| Type | Formula | Example | |------|---------|---------| | Curiosity | "What nobody tells you about [X]" | "What nobody tells you about growing on LinkedIn" | | Contrarian | "Unpopular opinion: [statement]" | "Unpopular opinion: followers don't matter" | | Story | "Last [time], I [experience]" | "Last week, I lost a $50K deal" | | Question | "What if I told you [possibility]?" | "What if I told you posting daily hurts growth?" | | Number | "[X] [things] I wish I knew about [Y]" | "5 things I wish I knew about content creation" | | Mistake | "I made a [X] mistake" | "I made a $10,000 mistake with my first launch" | | Bold claim | "[X] is [surprising adjective]" | "Your content strategy is backwards" | | Social proof | "[X] people [result]" | "10,000 people asked me this question" |

The Hook-Value-CTA Framework

HOOK (First 3 lines):
- Pattern interrupt OR
- Curiosity gap OR
- Bold/contrarian statement OR
- Relatable story opening

VALUE (Body):
- 3-5 key insights OR
- Story with lesson OR
- Framework/process OR
- Practical tips

CTA (Closing):
- Question for comments OR
- Follow for more OR
- Save/share prompt OR
- Link in bio/comments

3-Mode Workflow

MODE 1: PLAN

1. **Understand Content Goals**

   - Platform(s): LinkedIn, Twitter, Instagram?
   - Purpose: Awareness, engagement, conversion?
   - Topic: What message/value to share?
   - Format: Single post, carousel, thread?

2. **Check References**

   # Check social media examples
   ls references/examples/social/

   # Analyze top-performing posts
   python scripts/content/analyze_social.py \
     --folder references/examples/social/linkedin/ \
     --output output/analysis/linkedin_patterns.json

3. **Select Hook Strategy**

• Match hook type to content
• Consider audience awareness level
• Plan CTA approach

4. **Document Plan**

   ## Social Content Plan

   ### Platform: [LinkedIn/Twitter/Instagram]
   ### Format: [Post/Thread/Carousel]
   ### Goal: [Engagement/Awareness/Conversion]

   ### Topic
   [Main message]

   ### Hook Approach
   [Hook type and angle]

   ### Key Points
   1. [Point 1]
   2. [Point 2]
   3. [Point 3]

   ### CTA
   [Engagement action]

MODE 2: CLARIFY

**Essential Questions:**

• "Which platform(s) is this for?"
• "What's the main message or insight?"
• "Is this educational, promotional, or personal?"
• "Any specific CTA you want?"

**Style Questions:**

• "What tone - professional, casual, provocative?"
• "Use emojis?"
• "How personal/vulnerable should it be?"

**Format Questions:**

• "Single post or carousel/thread?"
• "Should I create variants for A/B testing?"

MODE 3: IMPLEMENT

1. **Write Content**

   # Generate social post
   python scripts/content/write_social.py \
     --platform linkedin \
     --topic "Content creation tips" \
     --hook-type curiosity \
     --output output/content/social/

2. **Create Variants**

• Write 3 hook variations
• Different CTA options
• A/B testing versions

3. **Add Hashtags**

• Platform-appropriate count
• Mix of popular + niche

4. **Save Output**