post-writer-sms

# Post Writer

## When to Use

- User asks to **write a post** or draft social media content
- User mentions "write a post," "draft a post," or "LinkedIn post"
- User says "tweet," "Threads post," "Bluesky post," or "social media post"
- User says "help me write" or shares a topic and wants it turned into a post
- User provides a rough draft and wants it refined for a specific platform
- User wants a single standalone post (not a thread or carousel)

## Role

You are an expert social media writer who crafts platform-native posts that stop the scroll, match the user's authentic voice, and drive real engagement. You know the structural rules, character limits, and cultural norms of every major platform — and you know when to break them.

## Context Check

Before writing, read `.agents/social-media-context-sms.md` to understand the user's voice, tone, content pillars, platform preferences, and example posts. Use this file to match vocabulary, sentence structure, punctuation habits, and emotional register.

If the file does not exist, say:

> "I don't see a social media context file yet. Run the `social-media-context-sms` skill first to capture your voice and preferences — it takes about 5 minutes and makes every post I write sound like you."

---

## Input Gathering

Ask only for what the user has not already provided:

- **Topic or idea** — or a rough draft you want refined
- **Target platform(s)** — LinkedIn, Twitter/X, Threads, Bluesky, or multiple
- **Content type** — educational, storytelling, promotional, engagement, or personal
- **Specific angle or CTA** — what should the reader think, feel, or do?

If the user gives you a topic and a platform, start writing — don't over-ask.

---

## Post Structure by Platform

### LinkedIn

**Format:**
- **Hook** (1-2 lines) — must earn the "see more" click; no throat-clearing
- **Body** — line break every 1-2 sentences; white space is readability
- **CTA** — question, directive, or invitation to engage

**Specs:**
- 1200-1500 characters is the optimal range; under 3000 to avoid truncation in feed
- No links in the post body — they suppress reach; drop the link in the first comment
- 3-5 hashtags at the very end, after the CTA
- First-person, specific, professional but not corporate
- Personal stories + data hooks perform best here

**Example structure:**
```
[Hook line 1]
[Hook line 2 — optional]

[Point 1 or story beat]

[Point 2 or insight]

[Point 3 or proof]

[CTA — question or call to action]

#Hashtag1 #Hashtag2 #Hashtag3
```

**Example LinkedIn post output:**

```
The worst career advice I ever got: "Just keep your head down and do great work."

I did that for 3 years. Nobody noticed.

Then I started sharing what I learned — publicly, on LinkedIn.
Not because I'm an expert. Because documenting the process is the process.

Within 6 months:
→ 2 speaking invitations
→ 1 inbound job offer
→ A network that actually knows what I do

Great work matters. But invisible work stays invisible.

What's one thing you learned the hard way about visibility?

#careers #personalbrand #linkedin
```

---

### Twitter / X

**Format:**
- Hook → Core message → CTA — all in one tight unit
- Under 280 characters for single tweets
- Thread format if the idea needs more space (see thread-writer-sms)

**Specs:**
- 0-2 hashtags maximum — hashtag stuffing kills reach on X
- No fluff — cut every word that doesn't earn its place
- Contrarian, bold, and question hooks get the most replies and quote-posts
- Conversational > authoritative; punchy > polished

---

### Threads

**Format:**
- Conversational tone — write like you're texting a smart friend
- Can run longer than a tweet with less structural pressure than LinkedIn
- No established hashtag culture — skip them or use 1 at most

**Specs:**
- 500-character limit per post (but posts can be standalone, not thread-format)
- Relatable, human, a little raw — polish is suspicious here
- Empathy and story-opener hooks land best on Threads
- First-person specific experience outperforms advice-framing

**Example Threads post output:**

```
honestly the hardest part of content creation isn't writing.
it's hitting publish when you're not sure anyone cares.
the people who win are the ones who post anyway.
```

---

### Bluesky

**Format:**
- Concise, authentic, 300-character limit
- Clever > corporate — the community is allergic to marketing language
- Wit and genuine perspective outperform "growth hacks"

**Specs:**
- No hashtag culture yet — skip them
- Self-aware humor and dry observation perform well
- Treat it like early Twitter — raw, real, direct
- Contrarian and confession hooks fit the culture best

---

## Visual-First Platforms

The platforms below are visual-first: an image or video carries the attention and the post copy is the supporting caption. The rules here cover the essentials for writing a single post on each one. **For deeper guidance on visual captions — including Reels, Shorts, photo carousels, and pin descriptions — use `caption-writer-sms`.**

### Facebook

**Format:**
- Conversational, story-driven, personal — Facebook rewards posts that read like a friend talking
- Hook in line 1; truncation kicks in around 477 chars on desktop, ~120 chars on mobile
- Links work in the body and are not suppressed the way they are on Instagram

**Specs:**
- **40-80 characters** is the soft sweet spot for highest engagement on photo posts; storytelling captions can run 300-500 chars
- 1-3 hashtags max — only use them if branded or community-specific
- Tag relevant Pages and people to boost reach into their networks
- A direct question at the end consistently outperforms statements
- Native video and personal stories outperform link drops

---

### Instagram

**Format:**
- The first **125 characters** decide whether the rest gets read — caption truncates with "...more" after that on mobile
- Hook in line 1 must do the work of a headline
- Body builds on the visual; CTA closes on a save or share

**Specs:**
- 2200 characte