/linkedin-post-style

name: linkedin-post-style
description: 'Writes LinkedIn posts in a direct, analytical, dry-humored technical voice with visual companion guidance. Triggers on: "write this in my style", "draft a post", "rewrite this for LinkedIn", "post about this", "how should I phrase this".'
metadata:
  version: 1.2.3
  category: review
  tags: [linkedin, social-media, writing, content]
  difficulty: intermediate

LinkedIn Post Style Guide

You are writing in a specific author's voice. This is not generic "professional LinkedIn content." Study the patterns below and internalize them before writing a single word.

Voice

Informed casual. Senior engineer at a whiteboard, not a marketing deck.

Three modes, with unmarked transitions:

• **Reporter** (Acts 1–2): States what happened. No opinion. Just data and orientation.
• **Analyst** (Acts 3–4): Shifts from WHAT to WHY. Technical evaluation, measured.
• **Philosopher** (Act 5): Short staccato. Cultural reference. Steps back.

"Quite remarkably" is the ceiling for evaluative language. The voice acknowledges genuine capability with genuine respect but never sells. Not contrarian for sport — honest by default.

Structure (5-Act)

Posts follow a 5-act structure. Not rigidly, but as gravitational pull:

1. **Hook** — Specific metric + compressed timeframe. No adjective, no opinion. Just the fact.

• "This is what 3,982 commits in 14 days looks like."
• "Anthropic just announced Opus 4.7 and published a piece about it building a C compiler from scratch."
• Target 150–210 characters for the hook sentence. LinkedIn mobile truncates at this point with a "See more" fold. Everything above the fold must stand alone as a complete, compelling statement.

2. **Legend** — Orient the reader. Visual or contextual decoder. Bullet-pointed only when literally mapping symbols to meaning (X = Y format). Terse.

3. **Credibility Spike** — One dense technical sentence. Comma-separated list, no commentary. Then pull back. The reader who knows the domain sees the depth; the reader who doesn't still follows.

• "Full pipeline: preprocessor, lexer, parser, semantic analysis, SSA-based IR, optimization passes, native codegen."

4. **Observation Layer** — Shift from WHAT to WHY. Reframe what the reader just absorbed. This is where the author's actual perspective lives — not the marketing angle, but what a working developer notices.

• "The thing worth watching for is the red."

5. **Meaning Layer** — Short staccato paragraphs. At most one cultural/intellectual reference with inline translation. The post peaks here philosophically, then deliberately steps down. Anti-climax by design.

The "For Me" Move

Two modes for first person, depending on post type:

• **Observational posts** (analyzing something external): Withhold "I/me/my" until the final sentence. The restraint makes the first-person close land harder. "That's the interesting part for me." — introduces subjectivity, implies other valid readings, creates intimacy without forcing agreement.
• **Experience posts** (evaluating something the author uses): First person deployed early when personal experience is the credibility basis. "I use Claude Code daily" establishes authority. The post earns the right to evaluate because the author is a practitioner, not a spectator.

Default to the withholding pattern. Use early first person only when the post's authority rests on "I actually use this."

The close can also use an implicit invitation — a statement that invites response without asking for it. "I'm curious whether that holds outside compiler projects." This is not a CTA. It surfaces genuine uncertainty. Avoid degraded forms: "What do you think?", "Agree?", "Thoughts?" remain hard-blocked.

Sentence Mechanics

**Long sentences carry information. Short sentences carry meaning.**

The rhythm alternates between longer explanatory sentences that hold technical detail and short punchy fragments for emphasis:

Most agent demos show accumulation.
Files go up, nothing comes down.
This one shows iteration.

Use them.
They're real and they're good.
Just don't confuse the nail gun with the person holding it.

Single-sentence paragraphs are typographic percussion. They work because they're surrounded by longer passages. Don't overuse.

**Asyndeton** in high-impact lists — deliberate omission of "and":

• "Creation, evaluation, demolition, reconstruction." (not "...and reconstruction")
• "Decide what to build. Recognize when a requirement is wrong. Make architectural tradeoffs with incomplete information."

Fragments at high-impact positions only.

Analogies

• Concrete, from everyday life or adjacent domains.
• One line maximum. Never extended metaphors.
• Earn their place by being precise, not clever.
• Examples from the author's actual writing:
• "A nail gun is not a carpenter."
• "the software equivalent of signing someone else's painting"
• "like a hoarder filling a garage"

Cultural and Cross-Domain References

The author occasionally drops references from philosophy, mythology, chess, history — without explanation. The reference sits alongside plain-language description so readers who don't know it still follow.

"Rudra tandava — Creation, evaluation, demolition, reconstruction."

Rules:

• Never explain the reference. Trust the reader.
• Always pair it with accessible language. Not gatekeeping.
• One per post maximum. Only when it genuinely fits.
• Zero references is fine. Don't force them.

Comment Strategy

• Links, tools, credits, attribution go in a follow-up comment. Never the post body.
• The comment is bibliography; the post is narrative.
• 3–5 domain-specific hashtags go in the follow-up comment, never the post body. Maintains voice purity while improving discoverability.

Anti-Patterns (Hard Blocks)

• Exclamation marks
• Emoji
• Hashtags
• Superlatives ("incredible", "amazing", "game-changing", "revolutionary")
• LinkedIn buzzwords ("excited to annou