Social Media Posts

Social Media Posts

Overview

Generate ready-to-paste social media copy for three platforms: Facebook, X, LinkedIn. Posts match the author's voice: direct, second person, concise, technically grounded. Include real metrics or results when available. No corporate fluff.

2026 key insight: Links in post bodies suppress reach on all three platforms. Always put URLs in the first comment (LinkedIn, Facebook) or first self-reply (X). Write the post as pure text.

Voice Rules

Hashtag Rules

Platform Guidelines

X (Twitter)

• Post body: 70-150 characters. Short punchy statement or concrete outcome. No link in the body — links suppress reach.
• Link goes in your first self-reply, posted immediately after. This is the standard pattern in 2026.
• Embed hashtags naturally in the sentence rather than appending. 1-2 max.
• Single post only. No threads unless you genuinely have 4+ connected points — threads are for teaching, single posts win for reach.
• First 30 minutes are the critical distribution window. Early engagement (especially retweets) weights the algorithm heavily.

LinkedIn

• 1,200-1,800 characters for technical/developer content. This range outperforms both shorter and longer posts for the audience.
• Hook in the first 2-3 lines (before "see more"). Lead with the outcome or problem, not preamble. This is the single biggest factor in whether the post gets expanded.
• Line breaks every 1-3 lines. Walls of text kill engagement.
• Link goes in the first comment, not the post body. Link-in-comment delivers ~2.9x more reach and ~2.7x more clicks than link-in-post (documented A/B tests, 2025-2026).
• 3-5 niche hashtags at the bottom of the post body.
• Professional but not stiff. Write like you're explaining to a peer.

Facebook

• 2-3 short paragraphs. Hook, context, result.
• Text-only post body — no link in the body. Link goes in the first comment. Text posts reach further than link posts on personal profiles.
• 1-2 hashtags at the end. They won't meaningfully expand reach beyond your existing network — they're decorative. Keep them or skip them; don't use more than 2.
• Expect reach limited to your existing network. Facebook text posts don't surface to non-followers in 2026. Optimize for the audience you have, not discovery.

Output Format

Save the social copy as a markdown file. Three platforms only — no Mastodon, no Bluesky.

The file captures the post body copy and the first-comment/reply URL separately, so the poster knows what to put where.

# [Post or Announcement Title]

Reference URL: https://...

## X

[Post body — 70-150 chars, no link, hashtags embedded naturally]

**First reply:**
[URL]

## LinkedIn

[Post body — 1,200-1,800 chars, hook first, line breaks, hashtags at bottom, no link]

**First comment:**
[URL]

## Facebook

[Post body — 2-3 paragraphs, no link, 1-2 hashtags at end]

**First comment:**
[URL]

Where to save

• For blog posts: docs/social/{slug}.md in the blog repo.
• For text posts (no blog post): docs/social/{topic-slug}.md in the blog repo.
• Always use the same slug as the source content.

Content Types

Blog Post Promotion

1. Read the blog post (fetch URL or read local file).
2. Identify the core insight or result. What would make someone click?
3. If the post has data (audit scores, performance numbers, before/after), lead with it.
4. The canonical blog URL goes in the first comment/reply — not the post body.

Dev Work Text Post (no blog post)

1. State what was built or fixed and the concrete outcome.
2. Always include a GitHub reference the reader can actually look at: a commit, PR, issue, file, or diff. Without this it is just narrative about something invisible.
3. If the work has a vibe coding angle (AI-assisted), surface it where authentic — don't force it.
4. The GitHub URL goes in the first comment/reply on each platform.

Milestone / Release Announcement

1. State what shipped and why it matters.
2. Include one concrete metric or outcome if available.
3. Link to the relevant post, PR, or changelog — in the first comment/reply.

Audit / Report Results

1. Lead with the most surprising or impactful finding.
2. Include specific numbers (compliance scores, divergence counts, candidates found).
3. Link to the full report or blog post — in the first comment/reply.

Common Mistakes