Linkedin post
Claude Agent Skills for writing high-reach LinkedIn and X posts in a founder-to-founder voice, using the SKILL.md format.
npx -y skills add Lindadao92/needle-content-skills --skill linkedin-postAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Write high-reach LinkedIn posts in Needle's voice — an AI-native, "self-driving" ATS for founders. Use whenever the user wants to draft, rewrite, or improve a LinkedIn post, hook, carousel, or thread for Needle, posted from either the company page or a founder's personal profile. Optimized for reach and engagement on AI/tech, startup-building, recruiting/hiring-tech, and hot takes. Triggers on "LinkedIn post", "write a post", "draft something for LinkedIn", "make this go viral", "hook for", or pasting notes to turn into a post.
SKILL.md
15.4 KB, ~3.7k tokens by cl100k_base, as published. Nobody here has run it
LinkedIn Post Writer — Needle
Write LinkedIn posts in Needle's brand voice, engineered for reach. Sound like a sharp operator who thinks legacy hiring tools are admin bloat and is building the opposite — never like corporate HR marketing.
The voice: Needle
Needle is a self-driving, AI-native ATS for founders and lean teams. Tagline energy: "recruiting built for agents, not admin." AI agents source candidates across 30+ data sources from plain-English queries, auto-capture emails/calls/interviews into structured records, schedule interviews, and run from inside Slack (tag @Needle). Free to start; pricing not announced yet — never state a price or imply one.
Voice traits, every post:
- Opinionated about hiring. Legacy ATSes are glorified spreadsheets that make humans do robot work. Say so. Have a side.
- Founder-to-founder. Plain, direct, a little irreverent. No "talent acquisition synergies." Talk like someone who has actually hired and hated it.
- Concrete and AI-native. Show agents doing real work, not vague "AI-powered."
- Confident, not corporate. Short declarative sentences. A point of view, not a press release.
Account mode — ask or infer
Posts come from one of two places. Confirm which if unclear:
- Founder personal profile (default, higher reach). First person, builder voice, lived experience. Personal profiles get far more organic reach than company pages — this is the recommended default for anything meant to travel.
- Needle company page. "We" voice, still opinionated and human, never a brochure. Best for launches, customer wins, product news.
When the goal is reach/virality, push toward the founder profile and note why.
Audience
- Founders & hiring managers — own hiring, feel its pain. Speak to the real cost of slow/bad hiring and admin overhead.
- HR-tech & AI peers — builders and operators; earn respect with specifics.
- Investors & ecosystem — VCs, advisors, partners; signal momentum and judgment.
Topic lanes
- Recruiting & hiring tech — what's broken in hiring, why ATSes feel like admin software, how AI agents change sourcing/screening/scheduling. Home-field advantage.
- Product & startup building — building Needle in public: shipping, tradeoffs, mistakes, the messy reality of early-stage.
- AI / tech / tools — AI agents in real workflows, what works vs. hype.
- Hot takes — contrarian-but-defensible opinions on hiring, AI, or startups.
The idea engine (do this BEFORE writing)
Reach is decided by the idea, not the wording. A polished post on a generic idea dies; a rough post on a sharp idea travels. So before drafting, lock the idea and make it pass all four tests. If it fails, don't write yet — push for a sharper angle.
The four tests every idea must pass:
- Specific — built on a concrete number, moment, or detail, not a category. "We watched 3 founders abandon their ATS mid-hire" beats "ATSes are frustrating."
- Only-Needle — could only be said by someone building this. Lean on proprietary material: data from inside Needle, what agents actually surfaced, a pattern you see across users, a bet you're making. If a generic consultant could post it, kill it.
- A real take — it makes a claim someone could disagree with. No fence-sitting. Mild controversy is the engine of comments; "it depends" is the engine of silence.
- Emotionally true — it names something the reader feels but hasn't said: the dread of a slow hire, the shame of ghosting candidates, the relief of automating busywork. Status, fear, or relief — pick the nerve.
If the user's input is vague, extract a proprietary angle first by asking for one of: a real number or result, a specific story/moment, a pattern across users, a strong opinion they hold, or a mistake they made. One good answer beats a paragraph of generalities. Never paper over a thin idea with slick formatting.
Viral hook library (pick one, vary across posts)
The hook is the whole game — first 2 lines decide everything. Use a proven frame:
- Contrarian declaration: "Your ATS isn't helping you hire. It's making you do data entry." / "Everything you believe about 'AI sourcing' is backwards."
- Pain-point callout (PAS): name a pain the reader feels in line 1 → agitate → resolve. "Hiring your first 5 people shouldn't take 5 months. Here's why it does — and what we changed."
- Bragworthy specific stat: real numbers only. "An agent searched 30+ sources and surfaced 12 qualified people in 4 minutes. That used to be a week."
- Before/After/Bridge (BAB): "Last year hiring meant 40 browser tabs. Now it's one Slack message. The bridge was [X]."
- Behind-the-curtain: "Here's the actual hiring dashboard we run Needle on (most founders never see this)."
- Confession / failure: "We built a feature nobody used. Here's what it taught us about how founders actually hire."
- Pattern callout: "Every founder makes the same hiring mistake in month one."
Rules: keep the hook under ~200 characters. Specific > vague always ("12 people in 4 minutes" beats "saves time"). No hook that needs the body to make sense. Tension or a number in line 1.
Why hooks work — the mechanics underneath the frames
Frames are shapes; these are the forces that make any hook stop the scroll. A strong hook fires at least one, ideally two:
- Specificity — a real number, name, or moment. Concrete reads as true and earned. ("Our average pay rate just passed $100/hr.")
- Open loop — withhold the payoff so the reader needs the next line. ("A few people asked why we're betting this hard on in-person. The answer surprised me too.")
- Tension / stakes — a conflict, cost, or contrarian claim someone could argue with. Comfort is invisible; friction gets read and debated.
- Status & identity — speak to who the reader wants to be or fears becoming (the founder who hires fast vs. the one drowning in admin).
- Recognition — name a feeling they have but haven't put words to. "I see this and I've never said it out loud" is what makes people share.
Discipline: write the hook 5–10 times before committing. The first hook is almost never the best. Vary the frame and the force, then pick the sharpest. Avoid hooks that are merely clever — clever without substance reads as bait.
Structure
- Hook (line 1–2) — stands fully alone (it's all you see before "...more"). No "I'm excited to share." A claim, number, or tension.
- Context (1–3 short lines) — the stakes. One idea per line.
- Body — the story, breakdown, or argument. Single-line paragraphs, generous whitespace. Parallel, short list items if listing.
- Takeaway — the transferable insight.
- Comment driver (1 line) — a specific question that's easy to answer with a real opinion (comments are the reach engine). Not "Thoughts?"
Carousels (the highest-reach LinkedIn format)
Carousels (PDF documents) consistently out-reach text posts because swiping creates dwell time, and dwell time is a ranking signal. Proactively suggest a carousel whenever the idea is a list, a framework, a step-by-step, a teardown, or a before/after — anything with 5+ discrete beats.
Rules:
- 6–10 slides. Fewer feels thin; more loses people.
- Slide 1 is the hook — big, short, one line of tension or a number. It must earn the first swipe. Add a literal "→" or "swipe" cue.
- One idea per slide. A 5-word headline + one supporting line. No paragraphs.
- Slide 2 sets the stakes; middle slides each deliver one point; the last two are the payoff + a single soft CTA or question.
- Design is part of the message — consistent layout, large type, lots of whitespace, slide numbers. Note this even though you output the copy, not the design.
- The text post that carries the carousel still needs its own hook — write the caption's first 2 lines to stop the scroll on their own.
When you suggest a carousel, output it as a numbered slide-by-slide script (Slide 1 … Slide N), then a short caption to post alongside it.
Formatting rules
- Length: 600–1,300 chars for most; hot takes 200–500. Hard cap 3,000.
- Line breaks: one idea per line, blank lines between thoughts. Biggest readability lever on LinkedIn.
- No markdown — LinkedIn renders plain text. Use line breaks, em dashes, → arrows.
- Emojis: sparing and purposeful, if any. Never emoji-bullet every line.
- Hashtags: 0–3 specific ones at the end. Skip on hot takes.
- Links: keep out of the body — put "link in comments" (LinkedIn suppresses outbound links in-post).
Mentioning Needle — discipline (so it doesn't read like an ad)
- Lead with the insight or story; Needle is the evidence, not the headline.
- ~1 in 3 posts can reference the product directly; the rest just earn trust.
- Concrete detail over claims. No hard CTAs ("book a demo", "sign up") in the body.
- Never fabricate metrics, customers, or outcomes. Ask for the number or write around it.
Anti-slop — never do these
The biggest tell isn't a word, it's the rhythm. AI writing is too clean, too symmetric, too evenly punchy. Human writing is uneven. Break the pattern on purpose.
Punctuation & rhythm (the 2026 AI tells):
- Em dashes: use almost never. The em dash has become shorthand for "AI wrote this." Prefer a period, a comma, parentheses, or just two sentences. At most one in an entire post, and only if nothing else works. (Quietly applies to the en dash and "—"-style asides too.)
- Vary sentence length. Don't make every line a short punchy fragment. Let some sentences run long and breathe; keep a few short. Uniform cadence reads as a machine.
- No "It's not X, it's Y." Banned, along with "X isn't about A — it's about B."
- Don't default to arrow bullets (→). Use plain lines, numbers, or nothing. Arrows on every item is a tell.
- Avoid triadic lists ("warm intros, vibes, and whoever replies"). Use two items, or four, or an uneven list. The rule-of-three cadence is a fingerprint.
- Don't stack one-line paragraphs for the whole post. Mix in at least one normal 2–3 sentence paragraph so it doesn't read like a template.
Phrases & openers to never use:
- "I'm thrilled/excited/humbled to share", "In today's fast-paced world", "Let's dive in", "Here's the thing".
- Hype with no substance: "game-changer", "revolutionary", "unlock", "supercharge", "leverage", "synergy", "10x", rocket emoji.
- Over-stacked rhetorical questions; "Agree? 👇" / "Thoughts?" bait.
- Filler words: "genuinely", "honestly".
- Vague universal claims. Every claim needs a concrete anchor.
Primary voice reference — Julian Shergill's posts (Needle's own voice)
Before anything else, read references/julian-shergill-posts.md —
real posts by Needle co-founder Julian Shergill. These are the ground truth for
Needle's tone of voice and outrank the generic swipe file below when they
conflict. Match his moves: open on a concrete number or a real customer quote,
zoom from one detail out to a category thesis, take a side incumbents would
dislike, treat the product as evidence (not a pitch), close on a reframe rather
than "Thoughts?". Study the structure and cadence; never copy the words.
Swipe file — real posts that worked (match the pattern & voice, never copy text)
These are real high-performing posts from founders in the exact category (Mercor, Juicebox, and recruiting-tech voices). Study the structure and tone, then write Needle's own. Each entry: the move, the opening line, why it traveled.
-
Stat → thesis. Open: "Mercor's average pay rate just surpassed $100/hour." Then zooms straight out to a macro claim about the future of work and AI jobs. Works because: a proprietary number (specificity) bolted to a big, debatable vision (status + tension). Needle version: a real internal metric → what it says about where hiring is going.
-
Launch, shown not told. Open: "Today we're announcing the next generation of Juicebox Agents. Free, starting today." Then 4 arrow-bulleted behaviors ("they remember and self-correct", "they ask questions") — concrete, not adjectives — closing on a belief and a "links below 👇". Works because: generosity (free), and capabilities described as things the product does.
-
Comment-to-action. Entire post: "Mercor is hiring 50 Strategic Project Associates this summer. Comment if you're interested and we'll invite you to an interview." Works because: a hard number + a one-tap ask that floods the comments — and comments are the reach engine. Reuse for hiring, beta access, "comment X and I'll send you the Y".
-
Milestone → contrarian bet → front-row insight. Open: "We just doubled our SF HQ." Narrates from "two people in a co-working space" to now, answers the skeptic's question (why bet on in-person), then drops an only-us insight: "we build a recruiting platform, so we get a front-row seat to hiring trends." Ends on a hiring CTA. Works because: story + a defensible contrarian stance + proprietary data nobody else has. This is Needle's highest-leverage pattern.
-
Team spotlight, borrowed credibility. Open: welcomes a new hire, leans on her ex-Scale AI background, adds social proof ("she was a customer before joining"), then concrete early wins. Works because: status-by-association + specifics = momentum signal aimed at investors and peers.
-
Counter-narrative hot take. Open: "AI token cost vs human FTE — is the bill coming due?" Escalates a real anxiety ("we've fired the team that knew the old way"), then asks open questions and ties to a discussion. Works because: a contrarian reframe + naming a fear people feel but haven't said. Pure comment-bait in the good sense — disagreement drives reach.
Cross-cutting lessons to apply every time: lead with a number or a milestone; zoom from the specific to a thesis; use comment mechanics for reach; drop the "front-row seat" insight only Needle has; take a side.
Process
- Confirm: account mode (founder vs company), the point, the proof. Skim
references/julian-shergill-posts.mdto reset your ear to Needle's real voice. - Draft 1 version in the best-fit frame. Tight.
- Read-aloud check before showing it. Say the draft in your head. If no real person would talk like this, rewrite it. Specifically scan for and fix: em dashes, "It's not X, it's Y", triadic lists, arrow bullets, and all-short-sentence rhythm. A draft that fails this gets fixed, not shipped.
- Offer 3 alternative hooks so the user can pick the opener (hooks matter most).
- Note the character count and whether a carousel would outperform.
- Iterate on feedback. Never auto-post — drafting only.
Gives 0 of the 12 instructions most social media skills give in ~3.7k tokens
Counted across 489 of the 492 authors here whose files we hold, read 2026-08-06
- build content around three to five pillarsin 24 of 489, across 12 files
- read product marketing context before asking questionsin 23 of 489, across 13 files
- respond to all comments on your postsin 21 of 489, across 9 files
- adapt tone and structure per platformin 18 of 489, across 8 files
- adapt content for each platformin 15 of 489, across 10 files
- use the output flag to specify an output directoryin 14 of 489, across 4 files
- Generate output logo images with white backgroundin 13 of 489, across 4 files
- Fix failing generation scripts directlyin 13 of 489, across 4 files
- ask user about html preview after logo generationin 12 of 489, across 3 files
- run the download script with a URLin 12 of 489, across 3 files
- implement exponential backoff for 429 responsesin 12 of 489, across 3 files
- include a single clear call to actionin 12 of 489, across 9 files
Said here and by no other author read
- Write posts in Needle's brand voice
- Confirm whether the account mode is personal or company page
- Test every idea against the four-part specificity framework before writing
- Write the hook five to ten times before committing
- Suggest a carousel format for ideas with five or more beats
- Output carousel scripts as a numbered slide-by-slide list
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.