agentleFS
jsathjsath/claude-skills/skills/writing/linkedin-writer/SKILL.md

linkedin-writer

Skill14 starsChanged 33 days agoMITView on GitHub

Writes LinkedIn posts in the user's own voice, learned from 5 to 10 of their best posts, using formats ranked by measured reach and engagement (milestone, short prediction, origin story, lesson-learned, comparison hook, comment-keyword lead magnet) and a hard anti-slop test. Also researches what is winning in a niche from public posts, and returns ranked idea banks. Use when someone asks for a LinkedIn post, LinkedIn ideas, to turn a story or result into a post, or to make a LinkedIn draft sound less like AI. Drafts only; never posts.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Ask the user to paste 5 to 10 of their own best LinkedIn posts with impressions if they have them (each post's analytics shows it).

    line 14
  2. Distinctive:

    No setup ("I want to share...").

    line 52
  3. Distinctive:

    Never: em dashes, "I'm thrilled to announce", "delve", "leverage", "utilize", headers or bold in the body, more than 2 hashtags.

    line 56
  4. Distinctive:

    Every line is a staged one-line reveal or a "not X, but Y" contrast.

    line 75
  5. Distinctive:

    No numbers: write without them.

    line 103
  6. Distinctive:

    No web access in research mode: ask for pasted posts, say research ran on pasted data only.

    line 104

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

LinkedIn Writer

Posts that sound like you, built on formats that measurably travel, and filtered so nothing reads like interchangeable AI thought leadership.

By Johann (@johannships). The format ranking comes from scoring my own posts by impressions, likes, comments and reposts; the anti-slop test came from drafts I rejected.

Step 0: learn the voice (first run, then reuse)

Ask the user to paste 5 to 10 of their own best LinkedIn posts with impressions if they have them (each post's analytics shows it). Write voice.md next to this file:

  • capitalisation and punctuation habits
  • line pattern (one sentence per line? short paragraphs?)
  • typical hook types they use
  • words they use and words they never use
  • emoji, hashtag and tagging habits (count, do not guess)
  • CTA style
  • which of their posts did best and which format it was (map to the table below)

Show it once, apply corrections, reuse it after. No samples: use the defaults below and label the draft "default voice".

Inputs

  • Topic, story or result (required), with any real numbers.
  • Mode: draft (default), ideas, niche research, or edit (their text).
  • Audience: who should read it (e.g. COOs at mid-size companies). Ask if unclear; it changes everything.
  • Anything the user supplies (hook, bullets, CTA, a "use this" line) is locked. Improve around it. Never swap their hook for one that is merely similar.

Formats ranked by measured performance

FormatWhat it does bestShape
MilestoneHighest reach (about 2.5x the next format)State the win in one line. One proof line. Thank people. Short. A graphic helps.
Short predictionHigh reach, low engagement3 to 5 lines. One bold, specific claim. No hedging.
Origin storyStrong reachSurprising fact, specific context, credibility moment, what went wrong, one lesson.
Lesson-learned storyBest engagement rateCredibility hook, story, a lesson that challenges the usual advice.
Comparison hookGood engagement"X costs $Y. it took me Z." Then what it actually was.
Comment-keyword lead magnetMost commentsUseful asset, 3 to 5 bullets of what is inside, one proof line, "comment WORD and i'll send it". Link goes in a DM or comment, never in the body.
Product announcementWeakestOnly problem, what you built, what it does. Keep it short.

Notes from the data:

  • Photos of the author or a branded graphic lifted reach on every format.
  • Keyword CTAs inflate comments; they do not prove buyer quality.
  • One acquisition or funding post can out-travel everything. Do not imitate that structure without an equal event.

Voice defaults (overridden by voice.md)

  • One thought per line, lots of whitespace. Most lines under 12 words. Fragments are fine.
  • No setup ("I want to share..."). Start inside the story.
  • Real numbers, only ones the user gave you.
  • Let the lesson come through the story; do not announce "here's what i learned".
  • Soft CTAs only ("feel free to reach out"). Never "LIKE and SHARE".
  • Never: em dashes, "I'm thrilled to announce", "delve", "leverage", "utilize", headers or bold in the body, more than 2 hashtags.

Example (milestone, default voice):

just sold my second company

idea to exit in 10 months. fully bootstrapped.

big thanks to everyone who helped make this happen

Anti-slop test (run on every draft)

Reject and rewrite if any is true:

  • It still works for another industry after swapping three nouns.
  • The hook is a broad claim ("AI is changing everything") with no proof or tension in line 2.
  • It lists verbs (pull, flag, draft, route, approve) with no recognisable scene.
  • It claims "fewer delays" or "more capacity" with no mechanism.
  • It invents a client, quote, outcome or permission.
  • Every line is a staged one-line reveal or a "not X, but Y" contrast.

Fix pattern: one recognisable problem in the reader's world, the evidence they would want, the human decision that stays, a specific consequence.

Mode: niche research ("what's winning in my niche")

Needs web access (WebSearch/WebFetch in Claude Code, or web search in Claude.ai). If none, ask the user to paste 5 to 10 posts with their visible reactions and comments.

  1. Find 7 to 10 recent public posts from credible operators in the niche. Record author, hook, full text, visible reactions and comments, date, URL.
  2. Split one-off events (acquisitions, funding, celebrity reach) from repeatable editorial wins.
  3. Name the repeatable openings: an operating scene, a surprising verified number, a defensible contrarian belief, or live product proof.
  4. Output a table (author, hook, engagement, repeatable lesson), then 3 hooks built from those patterns using the user's real context. Label counts with the date seen.

Mode: ideas

Return a ranked bank of 3 to 5 distinct concepts (not paraphrases of one thesis). For each: provisional hook, the real scene, the tension, what the reader gets, a proof visual, CTA or none, and a claim-status note (verified / user-said / needs checking). Before reusing a story, ask whether they already posted it; a new photo or hook does not make an old story new.

Mode: edit

  • "Improve this" or "in my voice": smooth their wording, cut repetition. Do not add a second thesis, a safety lecture or a new CTA.
  • "More concise": cut 40 to 60 percent at once. Keep the proof hook, one concrete example, the lesson, optional CTA.
  • "Sounds like AI": simplify. Ordinary words, fewer contrasts, less symmetry. Keep the concrete mechanism.

Output

Draft mode: only the post text, ready to paste. If asked for options, 2 to 3 with different hooks. Never name a client, employer or partner unless the user confirms it is approved for public use; default to category language ("two enterprise teams").

When something is missing

  • No numbers: write without them.
  • No web access in research mode: ask for pasted posts, say research ran on pasted data only.
  • Third-party article as the source: check the original and its date first. Never say "just published" about something old. Build an original take for the user's audience instead of paraphrasing.

Feedback log

Append rejections, edits and post results to feedback.md (date, format, result or correction, rule going forward). Read it first next time.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.