/post-writer

name: post-writer
description: Write a complete social media post (hook + body + CTA) from a topic or idea, sized for the target platform. Reads brand-brief.md for voice and audience context, applies proven hook patterns, and auto-runs post-grader as a final quality pass before returning the post. Triggers on "write me a post about X," "draft a [platform] post," or any specific writing request with a topic.
argument-hint: "[topic or idea] [platform]"
allowed-tools: Read, Write, Edit, Glob, AskUserQuestion

Post Writer

You take an idea and a platform, and return a finished post: hook, body, CTA. The output is graded and improved before the user sees it. They get a polished draft, not a first draft.

When to Activate

• "Write me a [platform] post about [topic]"
• "Draft an Instagram caption for [idea]"
• User has both a topic AND a platform in mind.

If the topic is missing, ask. If the platform is missing, ask. Don't fill in defaults.

Workflow

Step 1: Load context

1. Look for `brand-brief.md` in the current directory. **If missing, automatically invoke the `brand-brief` skill to capture it now.** Don't tell the user to "run brand-brief first" — just walk them through the brief, save it, then continue. 2. Read the brief once it exists. Pay special attention to the **Strong Opinion / Wedge** section — that's the viral fuel for contrarian-take and "most people think X" hooks. 3. Confirm the topic and platform with the user if either is unclear.

Step 2: Pick a hook pattern

**The hook is 50% of the post-grader score. If the hook is weak, the post can't recover.** Pick a pattern that fits the topic AND the user's wedge from `brand-brief.md`.

Choose ONE of these proven patterns. These are public templates from top short-form creators.

**1. The Reframe (one-liner flip)** > Common belief, flipped in one sentence. > Example: "Your 9-5 isn't killing your dreams. Wasting your 5-9 is."

**2. The Parallel Contrast** > [Group A] does X. [Group B] does Y. > Example: "Rich people buy time. Poor people buy stuff."

**3. The Specific Number Hook** > Lead with a concrete, surprising number. > Example: "I tested 47 candle scents. Only 3 sold."

**4. The Question Hook** > Open with a question that makes the reader stop and answer. > Example: "What's the one thing you'd quit if you weren't scared?"

**5. The Vulnerable Story Hook** > Drop the persona. Lead with a real moment. > Example: "I almost shut down my shop in March. Here's what saved it."

**6. The Contrarian Take** > State the unpopular position. > Example: "Most marketing advice is wrong for businesses under $10k/month."

**7. The Pain Point List** > Stack 2-3 specific pains the reader recognizes. > Example: "You spend hours writing posts. Nobody comments. You wonder if it's worth it."

**8. The Behind-the-Scenes Hook** > "Here's what nobody tells you about [thing]." > Example: "Here's what nobody tells you about handmade businesses."

**9. The Receipts Hook (high-virality, credibility-driven)** > "I [did specific thing] for [time period]. Here's what happened." > Or: "I tested [N] [things]. Only [smaller N] worked." > Example: "I tested 47 candle scents. Only 3 sold." > Example: "I posted on Instagram every day for 90 days. Engagement dropped 60%." > Why it works: specific numbers + earned right to speak + curiosity gap (what happened?).

**10. The "Most People" Reverse Hook (high-virality, polarizing)** > "Most people think [common belief]. Here's why they're wrong." > Or: "[Audience] keeps telling me [X]. They're missing the point." > Example: "Most candle makers think scent is the product. The product is calm." > Example: "Every coach tells you to find your niche. Find your enemy first." > Why it works: forces the reader to pick a side. Polarity drives comments. Pull the wedge from `brand-brief.md`.

**11. The Stolen Lesson Hook (high-virality, tactical)** > "I copied [specific thing]. Here's what happened." > Or: "[Famous person/brand] does [specific thing]. I tried it. Result: [outcome]." > Example: "I copied Apple's product page format. Sales went up 23%." > Example: "Hormozi gives away his entire course for free. I copied that. My email list 4x'd." > Why it works: borrowed credibility + tested-by-me proof + the reader can copy it too.

**Pattern picking guide:**

• Customer story → Vulnerable Story Hook (#5)
• Strong opinion / wedge → Reverse Hook (#10) or Reframe (#1)
• Numbers / data / case study → Receipts Hook (#9) or Specific Number Hook (#3)
• Industry critique → Reframe (#1), Contrarian Take (#6), or Reverse Hook (#10)
• Tip / how-to → Stolen Lesson Hook (#11) or Pain Point List (#7)
• Recognition / "you do this" → Pain Point List (#7) or Vulnerable Story (#5)

When in doubt, prefer #9, #10, or #11 — they have the highest virality ceiling.

Step 2.5: Iterate on the hook (CRITICAL)

Because hook = 50% of the score, write the hook FIRST and rewrite it 3-5 times before touching the body.

1. Draft 3 hook variations using different patterns from above. 2. Read each one out loud. Would you stop scrolling for it? 3. Apply the **first 3-words test**: do the first 3 words alone create curiosity, surprise, or emotional pull? "Here's what I" — fail. "I tested 47" — pass. "Most people think" — pass. 4. Pick the strongest variation. Refine it until every word earns its place. Cut filler ("really," "actually," "just," "the truth is"). 5. The final hook should pass these checks:

• Specific number, name, or moment in it (not abstract)
• Creates a question the reader needs answered
• Could stand alone as a tweet
• Doesn't sound like AI

Don't proceed to the body until the hook is genuinely strong. A weak hook = wasted body.

Step 3: Draft the body

Body rules (apply ALL):

• **Length**: Match platform constraints (see Platform Constraints below).
• **Specificity**: Use real numbers, real names, real situations. Not "many customers" — "the customer who emailed me Tuesday."
• **One idea**: One concrete