skills/linkedin-technical/SKILL.md
When the user wants to reach developers on LinkedIn, create technical content for B2B audiences, or understand when LinkedIn beats Twitter. Trigger phrases include "LinkedIn," "LinkedIn for developers," "B2B developer marketing," "engineering managers," "reaching CTOs," or "technical LinkedIn content."
npx skillsauth add jonathimer/devmarketing-skills linkedin-technicalInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
.agents/developer-audience-context.md if it exists| Factor | LinkedIn advantage | |--------|-------------------| | B2B decisions | Decision-makers are here | | Enterprise reach | CTOs, VPs, directors active | | Company context | See role, company, team size | | Professional network | Second-degree reach is valuable | | Long-form content | Articles rank in Google | | Lead generation | Built-in company/role targeting |
| Scenario | Why | |----------|-----| | Selling to enterprises | Buyers are on LinkedIn | | Reaching engineering managers | More managers here than Twitter | | Recruiting developer users | Professional context | | B2B partnerships | Companies > individuals | | Industry/vertical targeting | Company data available | | Longer professional content | Newsletters, articles |
| Scenario | Why | |----------|-----| | Individual developers | More devs on Twitter | | Real-time engagement | Faster conversation | | Open source projects | Community is on Twitter | | Casual/authentic voice | LinkedIn is more formal | | Technical hot takes | Twitter thrives on debate |
| Segment | Engagement level | What they consume | |---------|------------------|-------------------| | Engineering managers | High | Leadership, team building | | CTOs/VPs Engineering | Medium | Strategy, industry trends | | Tech recruiters | Very high | Talent, employer branding | | DevRel/Developer advocates | High | Community, content tactics | | Solution architects | Medium | Technical evaluations | | Individual developers | Lower | Career, learning |
| Content type | Performance | Notes | |--------------|-------------|-------| | Personal stories | Very high | LinkedIn loves narrative | | Career lessons | High | Professional growth content | | Contrarian opinions | High | "Unpopular opinion:" works | | Behind-the-scenes | High | Company/team stories | | Technical deep dives | Medium | More accessible than Twitter | | Plain announcements | Low | Need personal angle | | Shared links | Very low | Algorithm deprioritizes |
[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]
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?
| Type | Percentage | Purpose | |------|------------|---------| | Personal insights | 40% | Build authority | | Technical content | 30% | Demonstrate expertise | | Company/team stories | 20% | Employer branding | | Promotional | 10% | Actual asks |
| Element | Guideline | |---------|-----------| | First line | Hook — make them click "see more" | | Length | 1,200-1,500 characters optimal | | Line breaks | Every 1-2 sentences | | White space | Use blank lines liberally | | Emojis | Sparingly, for bullets (→, •) | | Hashtags | 3-5 at the end |
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:
| Format | Performance | Use for | |--------|-------------|---------| | Carousels (PDF) | Very high | Step-by-step, lists | | Native video | High | Demos, explanations | | Images | Medium | Diagrams, screenshots | | Text only | Medium | Stories, opinions | | Links | Low | External content |
Carousel tips:
| Use Case | Company Page | Personal Profile | |----------|--------------|------------------| | Product announcements | ✓ | Cross-post | | Company news | ✓ | Leadership shares | | Industry thought leadership | | ✓ | | Technical insights | | ✓ | | Hiring posts | ✓ | Hiring manager shares | | Customer stories | ✓ | Personal angle helps |
| Metric | Company Pages | Personal Profiles | |--------|---------------|-------------------| | Organic reach | Low (2-5%) | Higher (10-20%) | | Engagement | Lower | Higher | | Following growth | Slow | Faster | | Lead gen tools | Available | Limited | | Analytics | Better | Basic |
Strategy: Post from company page, have team members share with personal commentary.
| Topic | Why it resonates | |-------|------------------| | Team productivity | Their main metric | | Hiring/retention | Constant challenge | | Technical decisions | Balancing team + business | | Developer experience | Team satisfaction | | Technical debt | Constant negotiation | | Process improvements | Making teams effective |
| Angle | Example 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" |
| Hashtag | Audience | |---------|----------| | #engineering | Broad engineering | | #softwaredevelopment | General dev | | #webdevelopment | Web devs | | #devops | DevOps/SRE | | #cloudcomputing | Cloud/infra | | #startup | Startup audience | | #techleadership | EMs, VPs | | #remotework | Remote teams | | #hiring | Recruiting context | | #opensource | OSS community |
| Section | Best practice | |---------|---------------| | Photo | Professional, friendly | | Headline | [Role] at [Company] | [What you do/help with] | | About | Story format: background → now → what you share | | Featured | Pin your best posts, articles | | Experience | Focus on impact, not job duties | | Skills | Technical 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
| Articles | Posts | |----------|-------| | 1,000+ words | Under 1,500 characters | | SEO value (Google indexed) | No SEO | | Evergreen content | Timely/current | | Newsletter integration | One-time reach | | Lower immediate reach | Higher immediate reach |
| Tool | Use case | |------|----------| | Octolens | Monitor LinkedIn for mentions of your product, competitors, and relevant conversations. Track when your space gets discussed. | | Shield Analytics | Detailed LinkedIn analytics | | Taplio | Post scheduling and analytics | | AuthoredUp | Post formatting and preview | | Canva | Carousel design | | PDF carousels | Create in Canva, upload as PDF |
| Day | Content type | |-----|--------------| | Monday | Technical insight post | | Tuesday | Engage with others' content | | Wednesday | Personal/career story | | Thursday | Company news (shared personally) | | Friday | Industry opinion or hot take |
| Metric | What it tells you | |--------|-------------------| | Impressions | Reach of content | | Engagement rate | Content resonance | | Profile views | Interest generation | | Connection requests | Network growth | | Followers | Audience building | | Click-throughs | Action conversion | | Comments | Discussion value |
| Metric | Good | Great | |--------|------|-------| | Engagement rate | 2-3% | 5%+ | | Profile views/week | 50+ | 200+ | | Post reach | 500+ | 2000+ |
developer-audience-context — Know who you're reachingx-devs — Cross-post adapted contentgithub-presence — Link from LinkedIn to GitHubyoutube-devrel — Share video content on LinkedIndevelopment
When the user wants to create developer YouTube content, technical screencasts, or video tutorials. Trigger phrases include "YouTube," "developer video," "screencast," "video tutorial," "live coding," "YouTube for developers," "tech YouTube," or "YouTube thumbnails."
development
When the user wants to build a developer following on Twitter/X, write technical threads, or understand what works for dev audiences on X. Trigger phrases include "Twitter," "X," "developer Twitter," "tech Twitter," "technical threads," "building dev following," or "Twitter for developers."
development
Design pricing models that developers understand, accept, and can predict. Trigger phrases: usage-based pricing, API pricing, metered billing, developer pricing, pricing page, cost calculator, pay as you go, pricing transparency, competitive pricing, developer billing
development
When the user wants to create step-by-step technical tutorials, quickstarts, or code walkthroughs. Trigger phrases include "tutorial," "quickstart," "getting started guide," "walkthrough," "step by step," "how to guide," "hands-on guide," or "code tutorial."