mcpField
C
content-linkedin

content-linkedin

github.com/vstorm-coMarketing & growth2643 installsUpdated 28w ago
Repository

About content-linkedin

A LinkedIn post-writing skill for people shaping professional, personal posts from a topic, message, and audience. It offers three post formats, structure guidance, and checks against common low-substance patterns.

Key features

  1. 01Choose among three post types
  2. 02Shape hooks, body, and closing
  3. 03Adapt brand voice for LinkedIn
  4. 04Use post templates
  5. 05Check drafts against anti-patterns

Use cases

  1. 01Turn a career experience into a post
  2. 02Present a professional insight or framework
  3. 03Frame a contrarian industry view
  4. 04Review a draft for structure and tone

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vstorm-co/content-skills --skill content-linkedin

After installing, type/content-linkedinin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

linkedin-voice.md
templates/
contrarian-take.template
personal-story.template
professional-insight.template

Details

From the project README

LinkedIn Post Generation

Before You Start

  1. Check for brand voice: Read brand/VOICE.md if it exists. Adapt the brand voice for LinkedIn's professional-but-personal tone. If no voice file exists, default to professional, authentic, and insight-driven.

  2. Determine post type: Choose the format that fits the content:

    • Personal Story -- Lessons from experience (templates/personal-story.template)
    • Professional Insight -- Frameworks, observations, advice (templates/professional-insight.template)
    • Contrarian Take -- Challenging industry assumptions (templates/contrarian-take.template)
  3. Gather inputs: Topic, key message, target audience (role/seniority), any data or examples to include.


LinkedIn's Unique Culture

LinkedIn sits in a specific cultural space. Understand it before writing:

What works:

  • Professional experiences told as personal stories
  • Specific, actionable advice grounded in real experience
  • Vulnerable honesty about failures and lessons learned
  • Frameworks and mental models that help people think
  • Data-backed observations about industry trends
  • Asking genuine questions that invite thoughtful discussion

What doesn't work:

  • Corporate press releases disguised as personal posts
  • Vague inspirational platitudes ("Success is a journey, not a destination")
  • Humblebragging ("I'm so humbled to announce...")
  • Engagement bait without substance ("Agree?" "Thoughts?")
  • Reposting motivational quotes with "This." as your commentary
  • Multi-paragraph LinkedIn posts that are actually just ads

The core rule: LinkedIn rewards posts that make the reader think, learn, or reflect. If your post does none of these, rewrite it.


Post Structure

LinkedIn's algorithm and reading experience reward a specific structure:

Hook Line (First 1-2 Lines)
  • This is the only thing visible before "...see more"
  • It must create enough curiosity or value-promise to earn the click
  • Strong hooks: bold claim, surprising observation, specific result, a question
  • Weak hooks: "I'm excited to share...", "Big news!", generic statements
Body (Short Paragraphs with White Space)
  • Keep paragraphs to 1-3 sentences max
  • Use line breaks between paragraphs (LinkedIn's mobile experience demands white space)
  • One idea per paragraph
  • Build toward your main insight
  • Include at least one specific detail: a number, a name, a date, a quote
CTA / Close
  • End with a question that invites genuine discussion (not "Agree?")
  • Or end with a specific actionable takeaway
  • Or end with a forward-looking thought

Emoji Usage

LinkedIn has its own emoji culture. Rules:

Acceptable:

  • Bullet point substitutes (use sparingly, max 3-5 in a post)
  • A single emoji to punctuate a key line
  • Section markers in list-heavy posts

Not acceptable:

  • Every line starting with an emoji
  • Emoji walls or rainbow emoji sequences
  • Clapping hands between every word
  • Using emojis as a substitute for substance

Default: When in doubt, skip the emojis. Clean text with strong ideas performs better than decorated text with weak ideas.


LinkedIn Anti-Slop

These patterns are rampant on LinkedIn. Avoid all of them.

Phrases to Never Write
  • "I'm humbled to announce..."
  • "I'm thrilled to share..."
  • "Agree?"
  • "Thoughts?"
  • "This." (as a comment on a repost)
  • "If you're not doing X, you're falling behind"
  • "In today's rapidly changing landscape..."
  • "Here's the thing about {topic}..."
  • "Let that sink in."
  • "Read that again."
  • "I don't usually post about this, but..."
Structural Patterns to Avoid
  • The "I got fired, and it was the best thing that ever happened" formula (unless it genuinely was, with specific details)
  • Fake dialogue posts ("Interviewer: Why should we hire you? Me: Because I...")
  • "Day 1 vs Day 365" transformation posts without substance
  • Listing obvious advice as if it's revolutionary
  • Ending every post with a self-promotional CTA disguised as generosity
What to Do Instead
  • Share a specific moment, decision, or observation
  • Include details only you would know (this proves authenticity)
  • Let the reader draw their own conclusions from your story
  • If you have advice, ground it in a concrete experience, not abstract wisdom

Brand Voice Adaptation for LinkedIn

See linkedin-voice.md for detailed LinkedIn voice adaptation rules.

Key principles:

  • LinkedIn is more personal than a blog but more professional than X/Twitter
  • "I" is powerful on LinkedIn; individual perspective outperforms corporate voice
  • Technical depth is welcome but must be framed with business or career context
  • Storytelling beats instruction

Templates

TemplateUse Case
personal-story.templateLessons from experience, career moments, failures, wins
professional-insight.templateFrameworks, advice, industry observations
contrarian-take.templateChallenging assumptions, unpopular opinions

Output Checklist

Before delivering a LinkedIn post:

  • Hook line earns the "...see more" click
  • Paragraphs are short (1-3 sentences) with white space between them
  • At least one specific detail (number, name, date, quote)
  • No LinkedIn slop phrases (check the full list above)
  • Voice is professional but personal (not corporate, not casual)
  • Post makes the reader think, learn, or reflect
  • Closing invites genuine engagement or delivers a takeaway
  • Emoji usage is restrained and purposeful (or absent)
  • Length is appropriate: 150-300 words for most posts (LinkedIn penalizes very long posts in the algorithm)
  • Brand voice is adapted for LinkedIn's culture

Comments

Markdown supported