craft-linkedin-post

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:

1. Hook alternatives - Different opening approaches
2. Tone adjustment - More/less formal or casual
3. Length variants - Shorter version or expanded version
4. 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:

1. The post itself - Formatted and ready to copy
2. Hook assessment - Strength of the opening
3. Hashtag suggestions - Relevant tags
4. Posting tips - Timing and engagement advice
5. 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