mcpField
L
linkedin-technical

linkedin-technical

github.com/jonathimerMarketing & growth87112 installsUpdated 34w ago
Repository

About linkedin-technical

A LinkedIn content and operations guide for developer-tool teams seeking to reach engineering managers and business decision-makers. It covers audience differences, post formats, content planning, profile setup, and measurement.

Key features

  1. 01LinkedIn and Twitter channel guidance
  2. 02Technical post structure and formatting
  3. 03Content angles for engineering managers
  4. 04Company page and personal profile strategy
  5. 05Profile and article optimization
  6. 06Content calendar and performance metrics

Use cases

  1. 01Promote developer tools to enterprise buyers
  2. 02Plan technical content for engineering managers
  3. 03Schedule weekly LinkedIn publishing
  4. 04Assess post engagement and audience growth

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jonathimer/devmarketing-skills --skill linkedin-technical

After installing, type/linkedin-technicalin Claude Code to confirm it loaded.

Bundled filesREADME.md

Details

From the project README

LinkedIn for Technical Audiences

LinkedIn is where B2B developer tools win deals. This skill covers technical content that works on LinkedIn, reaching engineering managers and decision-makers, and knowing when LinkedIn beats Twitter.


Before You Start

  1. Read .agents/developer-audience-context.md if it exists
  2. Assess your LinkedIn presence (profile, connections, content history)
  3. Understand: LinkedIn rewards different content than developer Twitter

When LinkedIn Beats Twitter

LinkedIn's Unique Value
FactorLinkedIn advantage
B2B decisionsDecision-makers are here
Enterprise reachCTOs, VPs, directors active
Company contextSee role, company, team size
Professional networkSecond-degree reach is valuable
Long-form contentArticles rank in Google
Lead generationBuilt-in company/role targeting
Use LinkedIn When
ScenarioWhy
Selling to enterprisesBuyers are on LinkedIn
Reaching engineering managersMore managers here than Twitter
Recruiting developer usersProfessional context
B2B partnershipsCompanies > individuals
Industry/vertical targetingCompany data available
Longer professional contentNewsletters, articles
Use Twitter When
ScenarioWhy
Individual developersMore devs on Twitter
Real-time engagementFaster conversation
Open source projectsCommunity is on Twitter
Casual/authentic voiceLinkedIn is more formal
Technical hot takesTwitter thrives on debate

Understanding LinkedIn's Audience

Who's Actually Active
SegmentEngagement levelWhat they consume
Engineering managersHighLeadership, team building
CTOs/VPs EngineeringMediumStrategy, industry trends
Tech recruitersVery highTalent, employer branding
DevRel/Developer advocatesHighCommunity, content tactics
Solution architectsMediumTechnical evaluations
Individual developersLowerCareer, learning
What LinkedIn Values
Content typePerformanceNotes
Personal storiesVery highLinkedIn loves narrative
Career lessonsHighProfessional growth content
Contrarian opinionsHigh"Unpopular opinion:" works
Behind-the-scenesHighCompany/team stories
Technical deep divesMediumMore accessible than Twitter
Plain announcementsLowNeed personal angle
Shared linksVery lowAlgorithm deprioritizes

Content That Works

The LinkedIn Technical Post Formula
[Hook: Personal statement or question]

[Short paragraph: The context or problem]

[Bullet points: 3-5 key insights]

[Personal take: What you learned]

[CTA: Question or action]

---

[Hashtags: 3-5 relevant ones]
Example Formats

The "Here's What Happened" Post:

Last month we migrated 2TB of data from MongoDB to PostgreSQL.

Here's what we learned (and what we'd do differently):

→ Start with a test migration
   We didn't. Cost us 3 days.

→ Schema mapping is 80% of the work
   The actual migration is easy.

→ Watch for timezone handling
   MongoDB stores UTC, Postgres respects your settings.

→ Have a rollback plan
   Ours worked. Twice.

The migration took 4 days total, not the "weekend project" we planned.

What's your biggest database migration war story?

#engineering #databases #postgresql

The "Unpopular Opinion" Post:

Unpopular opinion: Most engineering teams don't need Kubernetes.

I've seen 3-person startups running K8s because "Netflix uses it."

The reality:
• Single container on Railway/Render: $20/month
• Managed K8s: $300/month minimum
• Self-hosted K8s: 1 FTE just for maintenance

Kubernetes is amazing for:
→ Multi-region deployments
→ Complex orchestration needs
→ 99.99% SLA requirements

But most apps? Docker Compose on a VM is fine.

What's the smallest team you've seen running Kubernetes?

#devops #kubernetes #startups

The "Behind the Scenes" Post:

We just hit 10,000 API calls per second.

Here's the unsexy truth about scaling:

6 months ago we could barely handle 1,000 req/s.

What changed:
→ Moved hot paths to Redis
→ Implemented connection pooling (finally)
→ Added CDN for static assets
→ Profiled and found 3 N+1 queries

No fancy architecture. No rewrite.
Just fixing obvious stuff we'd ignored.

The lesson: Optimize boring things first.

What's the simplest optimization that made your biggest impact?
Content Mix for LinkedIn
TypePercentagePurpose
Personal insights40%Build authority
Technical content30%Demonstrate expertise
Company/team stories20%Employer branding
Promotional10%Actual asks

Formatting Best Practices

Post Structure
ElementGuideline
First lineHook — make them click "see more"
Length1,200-1,500 characters optimal
Line breaksEvery 1-2 sentences
White spaceUse blank lines liberally
EmojisSparingly, for bullets (→, •)
Hashtags3-5 at the end
What Gets Hidden

LinkedIn truncates after ~210 characters. Your first 2-3 lines are critical.

Bad hook (no curiosity gap):

I wanted to share some thoughts about microservices.

Good hook (creates curiosity):

We ripped out our microservices architecture.

Here's why going back to a monolith was the right call:
Visual Content
FormatPerformanceUse for
Carousels (PDF)Very highStep-by-step, lists
Native videoHighDemos, explanations
ImagesMediumDiagrams, screenshots
Text onlyMediumStories, opinions
LinksLowExternal content

Carousel tips:

  • 5-10 slides optimal
  • First slide = thumbnail (make it count)
  • Large text, minimal per slide
  • Upload as PDF for carousel effect

Company Page vs Personal

When to Use Each
Use CaseCompany PagePersonal Profile
Product announcements✓Cross-post
Company news✓Leadership shares
Industry thought leadership✓
Technical insights✓
Hiring posts✓Hiring manager shares
Customer stories✓Personal angle helps
The Reality
MetricCompany PagesPersonal Profiles
Organic reachLow (2-5%)Higher (10-20%)
EngagementLowerHigher
Following growthSlowFaster
Lead gen toolsAvailableLimited
AnalyticsBetterBasic

Strategy: Post from company page, have team members share with personal commentary.


Reaching Engineering Managers

What Engineering Managers Care About
TopicWhy it resonates
Team productivityTheir main metric
Hiring/retentionConstant challenge
Technical decisionsBalancing team + business
Developer experienceTeam satisfaction
Technical debtConstant negotiation
Process improvementsMaking teams effective
Content Angles for EM Audience
AngleExample hook
Metrics"The 3 metrics our team tracks (and 5 we stopped tracking)"
Process"How we cut our sprint planning from 4 hours to 45 minutes"
Hiring"The technical interview question that tells us the most"
Tech decisions"Why we chose boring technology for our startup"
Team building"What I learned managing my first remote team"

Hashtags

Technical Hashtags That Work
HashtagAudience
#engineeringBroad engineering
#softwaredevelopmentGeneral dev
#webdevelopmentWeb devs
#devopsDevOps/SRE
#cloudcomputingCloud/infra
#startupStartup audience
#techleadershipEMs, VPs
#remoteworkRemote teams
#hiringRecruiting context
#opensourceOSS community
Hashtag Rules
  • 3-5 hashtags maximum
  • Put at the end of post
  • Mix broad (#engineering) and specific (#kubernetes)
  • Skip if post is personal/narrative

Platform-Specific Do's and Don'ts

Do's
  1. Do write posts, not status updates
  2. Do use line breaks liberally
  3. Do start with a hook
  4. Do share personal experiences
  5. Do engage in comments (first hour matters)
  6. Do cross-post from company page personally
  7. Do use carousels for educational content
  8. Do mention people and companies when relevant
Don'ts
  1. Don't post just links (algorithm kills them)
  2. Don't use LinkedIn like Twitter
  3. Don't over-hashtag (looks spammy)
  4. Don't be too promotional
  5. Don't ignore comments
  6. Don't post walls of text without breaks
  7. Don't share memes (different culture than Twitter)
  8. Don't buy engagement pods

Profile Optimization

Technical Professional Profile
SectionBest practice
PhotoProfessional, friendly
Headline[Role] at [Company]
AboutStory format: background → now → what you share
FeaturedPin your best posts, articles
ExperienceFocus on impact, not job duties
SkillsTechnical skills get endorsements

Headline examples:

Staff Engineer at Stripe | Building payments infrastructure

VP Engineering at Startup | Scaling teams from 5 to 50

DevRel at Supabase | Making databases accessible

LinkedIn Articles vs Posts

When to Use Articles
ArticlesPosts
1,000+ wordsUnder 1,500 characters
SEO value (Google indexed)No SEO
Evergreen contentTimely/current
Newsletter integrationOne-time reach
Lower immediate reachHigher immediate reach
Article Best Practices
  • Front-load value (assume people don't finish)
  • Use headers and formatting
  • Include visuals
  • End with CTA
  • Share as post after publishing

Tools

ToolUse case
OctolensMonitor LinkedIn for mentions of your product, competitors, and relevant conversations. Track when your space gets discussed.
Shield AnalyticsDetailed LinkedIn analytics
TaplioPost scheduling and analytics
AuthoredUpPost formatting and preview
CanvaCarousel design
PDF carouselsCreate in Canva, upload as PDF

Content Calendar

Weekly Template
DayContent type
MondayTechnical insight post
TuesdayEngage with others' content
WednesdayPersonal/career story
ThursdayCompany news (shared personally)
FridayIndustry opinion or hot take

Measuring Success

Metrics That Matter
MetricWhat it tells you
ImpressionsReach of content
Engagement rateContent resonance
Profile viewsInterest generation
Connection requestsNetwork growth
FollowersAudience building
Click-throughsAction conversion
CommentsDiscussion value
Good Benchmarks
MetricGoodGreat
Engagement rate2-3%5%+
Profile views/week50+200+
Post reach500+2000+

Related Skills

  • developer-audience-context — Know who you're reaching
  • x-devs — Cross-post adapted content
  • github-presence — Link from LinkedIn to GitHub
  • youtube-devrel — Share video content on LinkedIn

Comments

Markdown supported