linkedin-post-writer
Draft a new LinkedIn post from scratch using one of 20 2026 hook formulas (anaphora, R.I.P., time-anchor, curiosity-gap, contrarian, controlled A/B, false-binary, and more) plus a founders-edition angle library, picked by engagement goal (comments, reposts, likes, saves).
Install / Use
npx skills add sergebulaev/linkedin-skills --skill linkedin-post-writerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of linkedin-post-writer
linkedin-post-writer scores 89/100 on our quality scale, 1534th of 4,698 Development & Engineering skills we index (top 33%).
Its SKILL.md is 14 KB long, well organised into 10 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 5,507 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 20 days ago, so linkedin-post-writer is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
linkedin-post-writer compared with similar skills
All 4 of these similar skills score higher than linkedin-post-writer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| linkedin-post-writer (this skill)by sergebulaev | 89 | 5.5k | 20d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install linkedin-post-writer?
- Run
npx skills add sergebulaev/linkedin-skills --skill linkedin-post-writer. The install tabs above show the steps for each supported agent. - Which AI agents does linkedin-post-writer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is linkedin-post-writer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is linkedin-post-writer still maintained?
- The repository was last updated 20 days ago, so linkedin-post-writer is actively maintained.
Skill content
View source on GitHubname: linkedin-post-writer description: "Draft a new LinkedIn post from scratch using one of 20 2026 hook formulas (anaphora, R.I.P., time-anchor, curiosity-gap, contrarian, controlled A/B, false-binary, and more) plus a founders-edition angle library, picked by engagement goal (comments, reposts, likes, saves). Runs the humanizer pass and schedules via Publora on approval. Use to write a post, find a hook or proven format, or get founder-specific angles. Not for reviewing existing drafts (use linkedin-humanizer --mode audit)."
LinkedIn Post Writer
Ship long-form LinkedIn posts using hook formulas that actually performed in 2025-2026 (verified engagement multipliers).
When to use
- User says "write me a LinkedIn post about X"
- User has a topic + a rough angle and needs a hook + structure
- User wants to pick from known-winning formats and fill in their voice
- User wants to audit + schedule in one flow
Formulas this skill can use
| Code | Formula | Reference eng | Best for | |---|---|---|---| | F1 | Platform Risk Anaphora | 4,240 | Category/platform posts, product-as-fix | | F2 | R.I.P. Obituary | 3,822 | Era-ending claims, industry pivots | | F3 | Year-over-Year Pivot | 494, 3.74x | Identity shifts, founder reflection | | F4 | Time-Anchor Confession | 1,519+ | Vulnerability, voice reset, ICP re-targeting (2026: use with care, see caveats) | | F5 | Self-Proving Meta | 1,082 / 435 comments | Commitment-based posts, tests in public | | F6 | Comment-Gate Lead Magnet | 717-3,008 | List building (2026: use with care, real deliverable only, see caveats) | | F7 | Odd-Precision Money Ledger | 1,755, 9.4x | Founder build-log, cost breakdowns (2026: strongest opener, number-first) | | F8 | Paid-vs-Free Reversal | 550, 19.64x | Free framework give-away | | F9 | Curiosity-Gap Teaser | 306, 4.25x | Emergent behavior, behind-the-scenes (2026: use with care, pay off in 2 lines) | | F10 | Contrarian + Historical Receipts | 3,083 | Sacred-cow takes, AI/tech cycles | | F11 | Emotional Cold-Open | high-reach* | Real story with emotional stakes (likes) | | F12 | Permission Slip | comment-heavy* | Encouragement, reassurance (comments; 2026: use with care, needs a dated fact) | | F13 | Bait-and-Switch Reversal | high-reach* | Policy/process change that's an upgrade (likes) | | F14 | Named Gratitude / Tribute | repost-heavy* | Thanking mentors / team / departing colleague (reposts) | | F15 | Explain-to-Kids | save-heavy* | Demystifying jargon (saves) | | F16 | Status-Strip Humility | like-heavy* | Senior voice wanting warmth not distance (likes) | | F17 | Controlled A/B Anecdote | structural† | One-variable comparison, delegation/AI takes (comments) | | F18 | False-Binary Dissolve | structural† | "Both obvious answers fail" governance/strategy (comments/reposts; 2026: it is the post's one contrast) | | F19 | Anecdote-Meets-Evidence Bridge | structural† | Personal noticing + a data stack (comments/saves) | | F20 | Diverging-Curves Close | structural† | Two trajectories that diverge, quotable maxim (reposts) |
* F11-F16 reach is absolute 2026-corpus reach (often source-driven: a reshare or a famous author), NOT a baseline multiplier like the F1-F10 numbers. The two columns measure different things and are not comparable: F11's "256k" is raw reach, F8's "550, 19.64x" is a format multiplier. Do not rank formulas by putting these side by side. See ../../references/hook-formulas.md for each formula's real reference and caveats.
† F17-F20 are structural formulas: they shape the logic of a post (a controlled comparison, a false binary, an evidence bridge, two diverging curves) rather than its topic. They carry no reference number and are chosen by primary goal. They were built for the founders edition and several founder angles pin them by name.
Full skeletons in ../../references/hook-formulas.md. F1-F10 are the long-form thought-leadership set; F11-F16 (validated against a 2026 corpus of above-average performers) skew shorter and emotional and each carries a primary engagement goal.
2026 reach caveats (Sep 2026 audit)
The reference numbers above are unchanged; what changed is how the 2026 feed treats the device each formula leans on. Every formula in ../../references/hook-formulas.md now carries a "2026 reach note"; the ones that matter when picking:
- Never open with a question. Question as the first line is -34% median likes across all follower bands (MagicPost, 1.2M posts; vendor data, proprietary AI-score). Move the question to the close, where it is +3%.
- Prefer number-first. An odd-precision number in line 1 is +34% median likes (same source). F7 is the strongest 2026 opener; F3, F5, F17 are number-first by construction.
- F4 Confession, use with care: a specific, dated, uncomfortable fact with no "let me be honest" / "confession:" framing; substance inside the first 3 lines. Manufactured candor is the "false vulnerability" tell; genuine vulnerability is +7 to +10% (vendor data).
- F6 Comment-Gate, use with care: comment-gate CTAs are the named target of LinkedIn's March 2026 authenticity update, and the July 2026 "AI slop" report button cuts flagged posts ~40% views. Only with a real, named deliverable, and never "comment X to get Y" phrasing.
- F9 Curiosity-Gap, use with care: teaser phrases ("what nobody tells you", "what most people miss", "the real question is") are on the 2026 AI-tell consensus lists. The gap must be specific and pay off within 2 lines, before the fold.
- F12 Permission Slip and F18 False-Binary, use with care: both are generic-frame devices ("Stop X, start Y" -6.7%, "It's not X, it's Y" -4.9%, vendor data). They survive with a dated fact and as the post's only contrast.
- Density rule: one contrast and one triple per post, zero "The result?" / "Plot twist:" / "Here's what" bridges. 98-100% of top human creators still use these devices; the tell is repetition plus emptiness, not the device.
- Still lifts reach: number-first line, closing question, P.S. sign-off (+7.5%), 1,000+ chars (1.18x) and 20+ sentences (1.14x, AuthoredUp 3M posts), 1-2 sentence paragraphs with blank lines (recommended layout, not a tell).
Pick by goal first
If the user knows what they want the post to earn, start here, then narrow by topic. Canonical mapping: ../../references/hook-formulas.md → Engagement-goal split.
| Goal | Reach for | |---|---| | Comments | F17, F10, F4, F12, F9 (F4/F12/F9 with their 2026 caveats) | | Reposts | F14, F2, F8 | | Likes | F11, F13, F16 | | Saves | F15, F7, F8 |
Steps
Voice profile first (all drafts). If ../../references/voice-profile.md has filled: yes, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that linkedin-humanizer --mode profile can learn their voice from a few posts, then proceed with the generic voice rules. If ../../references/story-bank.md has filled: yes, load it too and take concrete details (numbers, dates, named projects) from there instead of asking mid-draft. Never invent a figure that is not in it; if the bank has nothing that fits, ask the user or offer linkedin-interviewer.
Founder mode (when the writer is a founder). Before picking a formula, open ../../references/founder-topics.md and offer a founder angle (A1-A10) that fits their goal. The angle picks the territory (reprice the category, the scarce-shots math, the delegation line, and so on); several angles pin the formula for you (A9 uses F17, A10 uses F18+F20). Founder angles compound trust with a narrow audience of investors, hires, and design partners rather than chasing broad reach. Fill the angle's bracketed slots with the founder's real numbers, then continue from step 3.
- Gather inputs. Topic, angle, draft ideas if the user has them, target audience (founders / operators / marketers), desired length (short 300-500 / medium 900-1300 / long 1500-1900 chars).
- Pick the formula. First ask (or infer) the goal: comments, reposts, likes, or saves. Use the "Pick by goal first" table to shortlist, then suggest 2-3 formulas that also fit the topic and let the user pick. Show the reference engagement number next to each, plus the formula's 2026 caveat if it has one. Two hook rules apply regardless of formula: never open with a question (-34% median likes; the question goes at the close, +3%) and prefer a number-first line (+34% median likes; both MagicPost vendor data, proprietary AI-score). If the best hook you have is a question, invert it into the number that answers it.
- Draft the post. Fill the formula skeleton with user voice. Respect the 2026 algorithm rules:
- Hook in first 210 chars (before "… see more"); line 1 is a statement or a number, never a question, never "Here's what/how", never "Stop X, start Y"
- Length: the target the user picked in step 1 wins. 900-1,300 chars is the default when they express no preference, not a ceiling over their choice. If they asked for long (1,500-1,900), write long and do not trim toward the sweet spot: 1,000+ chars and 20+ sentences carry a 1.18x / 1.14x reach lift (AuthoredUp, 3M posts), so the evidence runs with them, not against them. The one hard limit is LinkedIn's 3,000 characters.
- Double line-breaks between ideas, not single; 1-2 sentence paragraphs are the recommended layout
- One contrast and one triple per post maximum; no "The result?" / "Plot twist:" reveal bridges (Density rule in
../../references/hook-formulas.md) - Close with a specific question, and add a one-line P.S. when there is a real follow-up (+7.5%)
- 0-2 hashtags, placed at end
- No external links in body (move to first comment)
- Humanizer pass. Scrub 2026 AI vocab by density, cap em dashes (about one per 100 words), break stacked triads, generic openers and reveal bridges. Add at least 1 specific number, 1 named entity, 1 first-person concrete detail per 100 words.
- Run audit. Optionally invoke
linkedin-humanizer --mode auditfor algorithm + voice checks before showing to user. - Optional illustration. If the post would land better with a visual (or the user asks), offer one: draft an image and generate it with
lib.illustrate(prompt, kind="wide"), pulling brand handle/color from Voice & Brand Profile §6 for the overlay. Show the returnedurl+costin the approval card and attach it viamedia_urlson publish. For a multi-image grid (2-10 images in one post) uselib.illustrate_set([p1, p2, ...], kind="wide", overlay=brand)and pass everyurlinmedia_urls=[...]. For a quote-card of the hook, skip the model and typeset it:lib.quote_card("<hook line>", handle="@handle", style="brand")— crisp text, sameurlflow. Full workflow:../linkedin-humanizer/sub-skills/illustration.md. No Pixfaro key -> it drafts the prompt for the user to generate manually. - Approval card. Show: formula used, full draft, char count, suggested posting window (Tue/Wed/Thu 7:30-9:00 AM local), reaction targets from likely commenters, and the illustration (if any).
- On approval. Call
lib.publish(kind="post", draft_text=<approved>, target_url="https://www.linkedin.com/post/new/", platforms=[{"platform":"linkedin","platformId":<id>}], scheduled_time=<iso_or_None>, media_urls=<list_or_None>). The wrapper handles Publora / manual / diy routing. If the user reconsiders after approving, calllib.unpublish(post_group_id=<postGroupId from the response>)to cancel it before it goes out. On the publora tier the post is already queued, so the dashboard is otherwise the only way back.
Hard rules (from user feedback)
Global voice rules: see root SKILL.md §Voice rules. Additional skill-specific rules:
- Never frame LinkedIn as inferior in a LinkedIn post (algo penalty).
- Don't name-drop the user's product in a way that reads as self-promo. One mention max, and only when it's the natural conclusio
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
