Craft LinkedIn Post

Generate an engaging LinkedIn post optimized for developer audiences using proven storytelling frameworks.

Arguments

$ARGUMENTS - The topic, story idea, or content you want to share

Workflow

Step 1: Gather Context

If $ARGUMENTS is insufficient, use AskUserQuestion to gather:

Question 1: Post Type (header: "Post Type")

Learning/Mistake (share what you learned the hard way)
Behind the Build (how you built something)
Win/Milestone (celebrate an achievement)
Opinion/Take (share a perspective)
Quick Tip (tactical advice)

Question 2: Goal (header: "Goal")

Build authority (establish expertise)
Start discussion (spark conversation)
Share value (help others)
Announce something (news, milestone)
Connect (relate to audience)

Step 2: Select Storytelling Frame

Based on post type, apply the appropriate frame:

Frame 1: Learning the Hard Way

[Bold opening about the mistake]

Last [timeframe], I [what you did wrong].

Here's what happened:
→ [Consequence 1]
→ [Consequence 2]
→ [Consequence 3]

The lesson: [Key insight]

What's a lesson you learned the hard way?

Frame 2: Behind the Build

[What you built and why it matters]

Here's what nobody tells you about building [X]:

1. [Surprising challenge + how you solved it]
2. [Unexpected discovery]
3. [What you'd do differently]

The biggest lesson: [Key insight]

Have you built something similar?

Frame 3: Before/After

[The dramatic contrast]

Before: [Specific pain point]
After: [Specific improvement]

Here's what changed:

Step 1: [First change]
Step 2: [Second change]
Step 3: [Third change]

The key insight: [What made the biggest difference]

Frame 4: Contrarian Take

Unpopular opinion: [Your view]

I know this goes against [common wisdom].

But here's what I've seen:
→ [Evidence 1]
→ [Evidence 2]
→ [Evidence 3]

[Nuanced conclusion]

What's your experience?

Frame 5: Quick Win

A simple trick that [benefit]:

[Describe the technique]

Why it works:
→ [Reason 1]
→ [Reason 2]

I use this [when/how often].

What's your go-to hack?

Step 3: Craft the Hook

The first 1-2 lines determine if people click "see more."

Hook Techniques:

| Type | Example | | --- | --- | | Dramatic moment | "At 2 AM, I got the call no engineer wants." | | Surprising statement | "Our most productive engineer writes the least code." | | Honest confession | "I deleted 10,000 lines of code. My manager thanked me." | | Bold claim | "Everyone's doing microservices wrong. Including us." | | Question | "Why do we still write documentation nobody reads?" |

Step 4: Apply Formatting Best Practices

Structure:

One sentence per line
Use line breaks liberally (no walls of text)
Bullet points with → or • for lists
Bold key phrases sparingly
End with a question or CTA

Length:

Optimal: 150-300 words
Too short: Lacks substance
Too long: People won't finish

Engagement elements:

End with a question that invites sharing
Tag relevant people (if appropriate)
3-5 relevant hashtags (at end)

Step 5: Generate Post

Produce a complete, ready-to-post LinkedIn update:

## LinkedIn Post

---

[Hook line that makes people want to click "see more"]

[Second line that builds on the hook]

[Body content using selected storytelling frame]

[Key insight or takeaway]

[CTA - Question that invites engagement]

#hashtag1 #hashtag2 #hashtag3

---

### Optimization Notes
- **Hook strength:** [Assessment]
- **Storytelling frame:** [Which frame used]
- **Engagement prompt:** [What you're asking]
- **Best posting time:** [Suggestion based on audience]

Step 6: Offer Variations

After presenting the post, offer:

Hook alternatives - Different opening approaches
Tone adjustment - More/less formal or casual
Length variants - Shorter version or expanded version
Different frame - Same content, different structure

Example Usage

# With topic
/soft-skills:craft-linkedin-post I learned why you shouldn't deploy on Friday

# With story idea
/soft-skills:craft-linkedin-post We reduced our deploy time from 30 minutes to 3 minutes

# Start with questions
/soft-skills:craft-linkedin-post

Output

Present a complete, ready-to-post LinkedIn update with:

The post itself - Formatted and ready to copy
Hook assessment - Strength of the opening
Hashtag suggestions - Relevant tags
Posting tips - Timing and engagement advice
Alternative versions - If applicable

Quality Checklist

Before posting:

[ ] Hook makes people want to click "see more"
[ ] Contains specific details (not generic statements)
[ ] Has emotional texture (not just facts)
[ ] Clear takeaway for the reader
[ ] Ends with engagement prompt
[ ] Formatted with line breaks (no walls of text)
[ ] 3-5 relevant hashtags

Anti-Patterns to Avoid

Generic statements without specifics
Corporate jargon ("leveraging synergies")
All wins, no vulnerability
Missing call-to-action
Walls of text (no line breaks)
More than 5-7 hashtags
Tagging people who didn't contribute