Social Post Thread Writer

What this skill does

This skill converts any source material — a blog post, a rough idea, a document, a lesson learned, or a list of bullet points — into a polished, engagement-optimized Twitter/X or LinkedIn thread. It writes a strong hook, structures the content for maximum retention, and closes with a clear call to action. The output is ready to post.

Use this to turn any piece of knowledge into a social-first content piece, to build an audience around your expertise, or to share an idea in the format that actually gets read on social platforms.

How to use

Claude Code / Cline

Copy this file to .agents/skills/social-post-thread-writer/SKILL.md in your project root.

Then ask:

• "Use the Social Post Thread Writer skill to turn this blog post into a Twitter thread: [paste content]."
• "Write a LinkedIn thread about this idea using the Social Post Thread Writer skill: [describe idea]."

Provide:

• The source material (blog post, bullets, idea description, document)
• The target platform: Twitter/X or LinkedIn (or both)
• Your name or handle (for attribution if needed)
• Tone preferences: professional, casual, technical, storytelling
• Optional: a specific angle or point you want to emphasize

Cursor

Add the instructions below to your .cursorrules or paste them into the Cursor AI pane. Provide the source material and platform.

Codex

Paste the source material with the target platform specified. Ask Codex to follow the instructions below.

The Prompt / Instructions for the Agent

When asked to write a social thread, apply these instructions based on the platform:

---

For Twitter/X Threads

Structure

Tweet 1 — The Hook This is the most important tweet. It must make someone stop scrolling. Use one of these proven hook formulas:

• The counterintuitive claim: "The advice everyone gives about X is wrong."
• The surprising number: "I spent 2 years building X. Here's what I learned that nobody told me."
• The promise: "Here's how to [outcome] in [short timeframe/simple steps]."
• The bold statement: State the most controversial or surprising insight from the whole thread in one sentence.

Never start with "In this thread, I'll..." — it buries the hook. Start with the hook itself.

Tweets 2–N — The Body Each tweet is a standalone unit of value. Follow this pattern:

• One insight or point per tweet
• Lead with the point, then support it (not the other way around)
• Use concrete examples, numbers, or stories — not abstract generalities
• Short sentences. Numbered points within a tweet are fine (1. 2. 3.) but don't overuse them
• Leave the reader wanting the next tweet — end with a natural "because..." or "here's the thing:"

Final tweet — CTA Don't end with "Thanks for reading." Give the reader something:

• A link to the full article
• A question to answer in the replies
• A follow prompt: "Follow me for more on [topic]"
• A retweet ask if the content is genuinely shareable

Formatting rules

• Max 280 characters per tweet (count carefully)
• Number each tweet: 1/, 2/, etc.
• Use blank lines within tweets for visual breathing room
• Emojis are optional — use sparingly if the tone calls for it, not as decoration
• Hashtags: 0–2 in the last tweet only; never mid-thread

---

For LinkedIn Threads / Carousel-style Posts

LinkedIn doesn't have native threads, but long-form posts with clear structure (line breaks, short paragraphs, occasional bold) perform well. Write for this format:

Structure

Opening (2–3 lines) The hook. Must work as the preview text before "See more." The first line should create curiosity, tension, or a compelling claim. Don't bury the lead.

Body (3–5 short sections) Each section: a sub-point or step, written as a short paragraph (2–4 sentences). Use white space generously — walls of text get skipped.

Optional: Use bold sparingly for the most important phrase in each section.

Closing End with a question or reflection that invites comments. LinkedIn's algorithm rewards comment engagement heavily.

Footer

• Link to the full article or resource if applicable
• 3–5 hashtags (on their own line at the end)

Tone for LinkedIn

More reflective and personal than Twitter. LinkedIn rewards vulnerability and lessons-learned framing. "I used to think X. Here's what changed my mind." performs better than pure listicles.

---

Content principles (both platforms)

• Specificity beats generality: "I reduced my bug count by 40% using this one technique" > "this technique will make you a better developer"
• Show, don't tell: Instead of "it's very important", show why with a concrete example
• Cut ruthlessly: Every sentence that doesn't add value to the reader should be deleted
• Native format: Write for how people read social media (fast, scanning, on mobile) — not how they read articles

---

Output format

## Twitter/X Thread — [Working title]

1/ [Hook tweet]

2/ [Body tweet]

...

N/ [CTA tweet]

---

## LinkedIn Post — [Working title]

[Full LinkedIn post text]

If only one platform was requested, produce only that format.

Example

Input to Agent:

"Use the Social Post Thread Writer skill. Platform: Twitter/X. Tone: casual but thoughtful.

Source idea: I've noticed that most developers who say they don't have time to write documentation actually spend 3x more time answering the same questions in Slack over and over. Writing a 1-page doc once would save hours every month. The problem is that writing docs doesn't feel productive while you're doing it — it feels like a distraction. But answering Slack messages also doesn't feel unproductive, even though it's the same information repeated."

Output from Agent:

Twitter/X Thread — The hidden cost of skipping documentation

1/ Every developer who says "I don't have time to write docs" is spending 3x more time answering the same Slack messages.

The math is brutal. Here's why.

2/ A 1-page doc takes maybe 45 minutes to write.

A Slack DM takes 5 minutes.

Sounds like Slack wins.

But that 5-minute message gets sent to 8 different people. Over 6 months.

That's 4+ hours. Gone.

3/ The reason we keep choosing Slack?

Writing docs feels like a distraction. Answering messages feels like helping.

Same information. Completely different emotional signal.

4/ The reframe that worked for me:

A doc isn't documentation.

It's a tool that answers a question for every future person who has it — including future me at 11pm before a deadline.

5/ The 3-question test for "should I write a doc?":

1. Have I answered this question more than twice?
2. Will I need to answer it again in 6 months?
3. Could a new team member find the answer without asking?

If yes → write the doc. Now.

6/ The goal isn't documentation.

It's buying back your time in 5-minute increments, forever.

What's the one question you answer on repeat that you should just document already?

Notes

• The hook is worth rewriting 3–5 times. The first draft is rarely the best version. Ask the agent for 3 alternative hooks if the first one doesn't feel strong enough.
• For Twitter, read the thread out loud. If any tweet sounds stilted or unnatural, rewrite it.
• LinkedIn posts with a question at the end consistently get more comments than those that end with a statement. This matters for reach.