LinkedIn Marketing Skills

repository·main·Indexed 18 days ago

https://github.com/sergebulaev/linkedin-skills

A collection of 11 specialized AI skills for Claude Code, Codex, and other agents to automate LinkedIn marketing. Features include post writing with 2026 hook formulas, comment drafting, profile optimization, and content repurposing. Supports automatic data fetching via Apify and direct publishing through the Publora API. Compatible with Claude Desktop, Claude.ai, Codex CLI, Hermes Agent, OpenClaw, and generic Python agents via a provided utility library.

Tokens
65.7K
Snippets
110
Records
261
Agent score
64%

What's inside linkedin-skills

  1. Overview of LinkedIn Marketing Skills bundle

    main

    The linkedin-marketing bundle provides 11 specialized skills for LinkedIn content operations, designed for Claude Code and Codex. The skills follow a consistent draft → approval → publish workflow.

    Available Skills

    • linkedin-post-writer: Write viral posts.
    • linkedin-comment-drafter: Draft comments on specific post URLs.
    • linkedin-reply-handler: Reply to existing comments.
    • linkedin-humanizer: Audit drafts, remove AI tells, score emoji density, and run AI detectors (includes --mode audit).
    • linkedin-hook-extractor: Extract hook formulas from viral posts.
    • linkedin-content-planner: Plan a week of content.
    • linkedin-thread-monitor: Track which comments receive author replies.
    • linkedin-engager-analytics: Analyze audience segmentation (likes/comments).
    • linkedin-profile-optimizer: Audit or rewrite LinkedIn profiles.
    • linkedin-employee-advocacy: Run advocacy programs across teams.
    • linkedin-repurposer: Adapt content from other platforms (tweets, videos, blogs) into native LinkedIn posts.
  2. Understand the three humanizer modes (Forensic, Strict, Aesthetic)

    main

    The linkedin-humanizer uses a tiered approach to distinguish between actual AI leakage, bad writing style, and legitimate human literary patterns. This prevents the tool from 'flattening' good writing while still catching AI-generated content.

    Tier 1: FORENSIC (Always On)

    Targets pure leakage—patterns that no human writer produces. These are undeniable signals of AI origin.

    • Examples: Internal tool tokens (e.g., oaicite, contentReference), model disclaimers (e.g., "As of my last update..."), unpopulated placeholders (e.g., [Your Name]), and extreme em dash frequency (3+ in <300 words).

    Tier 2: STRICT (Default On)

    Targets bad-style overlap—corporate-speak and filler that AI uses heavily. Removing these improves post quality even if the writer is human.

    • Examples: Corporate synonyms (e.g., leverage, utilize, harness), filler adverbs (e.g., fundamentally, essentially), clichés (e.g., "in today's fast-paced world"), and negative parallelism ("X isn't Y, it's Z").

    Tier 3: AESTHETIC (Opt-in Only)

    Targets good-writing overlap—patterns AI uses that are also common in high-quality human writing. Using this mode blindly can flag legitimate authors as AI.

    • Examples: Single em dashes, the 'rule of three' (tricolons), passive voice, specific adjectives (e.g., robust, vibrant), and curly quotes.
    • When to use: Only for audiences that are extremely paranoid about AI detection (e.g., academic forums, Wikipedia editors).
  3. Native-fit rules for repurposing content

    main

    To ensure content feels native to LinkedIn, follow these transformation patterns:

    Source FormatLinkedIn Transformation
    TweetExpand the argument; use the tweet as a hook and grow it with whitespace.
    X ThreadUnroll the numbered list into one single, flowing post.
    YouTube Video / ScriptLead with the payoff, then the story. Place the video link in the first comment.
    Blog / NewsletterPick one quotable claim as the hook and one supporting story. Do not summarize the whole piece.
    Instagram / TikTokStrip emoji density and hashtag blocks; add professional stakes.
  4. Resolve conflicts between scrub rules and voice fingerprints

    main

    When a scrub rule (intended to remove AI tells) targets a token that is part of the user's identified voice fingerprint, the behavior depends on the execution tier:

    | Tier | Behavior |
    |---|---|
    | **Forensic** | **Always scrub.** If a voice fingerprint contains model leakage (e.g., `oaicite`), it is treated as pasted AI output. |
    | **Strict** | **Flag for user review.** Do not auto-substitute; let the user decide. |
    | **Aesthetic** | **Skip the rule.** Aesthetic rules are designed to tolerate human-writer defenses. |
  5. Preserve voice signatures in the LinkedIn Humanizer

    main

    The LinkedIn Humanizer is designed to be destructive to remove AI tells, but it must avoid destroying the user's unique 'voice.' Certain patterns are classified as voice signatures rather than AI tells and must be preserved unconditionally, even in --mode all.

    ### Unconditional Preservation List
    
    | Pattern | Why it's voice, not AI |
    |---|---|
    | Lowercase sentence starts (`closed our seed on a tuesday...`) | Deliberate cadence cue. |
    | `..` as a soft pause | The officially-blessed alternative to em dash. |
    | Sentence fragments (`Worth it.`, `Every time.`) | Pass 2 adds fragments; existing ones must stay. |
    | Contractions (`don't`, `it's`) | Mandatory for natural rhythm. |
    | First-person sensory detail (`my hands shook`) | Required for Pass 3. |
    | Specific numbers (`$47k`, `9:14am`) | Required for Pass 3. |
    | Named entities (`HubSpot`, `Tuesday morning`) | Must be capitalized properly. |
    | Self-correction (`actually no`, `correction:`) | Burstiness signal. |
  6. How the LinkedIn Post Audit execution flow works

    main

    The audit follows a specific sequence of operations to generate its report:

    1. Parsing: The draft is parsed into sentences, paragraphs, and the critical first-210-character hook.
    2. Blocker Check: The system runs all blocker checks first. If any blockers are found, the process returns a FAIL status immediately with specific fix suggestions and an optional auto-rewrite.
    3. Warning Check: If no blockers are present, the system proceeds to run the warnings checks.
    4. Scoring: The system estimates an OriginalityAI score using heuristic proxies: average sentence length variance, unique 3-gram ratio, and passive voice ratio.
    5. Reporting: A structured report is returned containing all findings.
  7. Understand the LinkedIn Humanizer scrubbing tiers

    main

    The humanizer uses a three-pass system to process text:

    Pass 1: SCRUB (Delete or Replace)

    Uses tiered regex catalogs to clean text:

    • FORENSIC (Always on): Targets model leakage like oaicite, contentReference, turn0search0, and knowledge-cutoff disclaimers.
    • STRICT (Default): Targets corporate-speak and bad LinkedIn style. Includes vocabulary swaps (e.g., leverage $\rightarrow$ use), filler adverb deletion, and banning negative parallelism.
    • AESTHETIC (Opt-in): Targets patterns AI uses that humans also use (e.g., rule-of-three, "robust", em dashes). Use with caution as it can flatten good writing.

    Pass 2: BREAK (Force Burstiness)

    Targets readability metrics (Flesch reading ease >55, sentence length variance >40%) by:

    • Breaking long sentences into fragments.
    • Adding asymmetric sentence structures.
    • Varying cadence.

    Pass 3: ADD (Human Fingerprints)

    Injects human-like elements (without fabricating facts):

    • Specific numbers (replacing "many" or "significant").
    • Named entities (people, companies, dates).
    • First-person sensory details or moments of vulnerability.
  8. Hard Stylistic Rules for Comments

    main

    Follow these strict formatting and capitalization rules to maintain a natural human voice:

    • Punctuation: Never use em dashes (), en dashes (), or double dashes (--). Instead, use .. as a soft pause to mimic human rhythm.
    • Capitalization: Always capitalize personal names, company names, and product names (e.g., HubSpot, Claude). While sentence starts can be lowercase for a natural feel, names within sentences must be capitalized.
    • Self-Reference: When commenting on third-party posts, do not mention your own product by name. Use descriptive phrases instead (e.g., "our AI content system" or "the platform we're building").
  9. Thread classification and response timing rules

    main

    The linkedin-thread-monitor uses specific time-based classifications to determine the value of a thread and the urgency of a response. Follow these guidelines to maximize thread momentum:

    StatusWindowRecommended Action
    Hot< 6hRespond within 90 minutes
    Warm6-24hRespond within 2 hours
    Cool24-72hRespond within 4 hours
    Dormant> 72hDo not reply in thread; switch to DM

    Hard Rules for Engagement:

    • No Thread Spam: Never chain 3+ replies under a single comment.
    • No Late Replies: Never reply to a thread later than 72h after the last turn; use DM instead.
    • Respect Deletions: If an author deletes their reply, do not respond.
    • Sequence: Do not DM a warm thread before replying publicly first.
  10. Understand the LinkedIn Rules Explainer taxonomy

    main

    The linkedin-humanizer package uses a three-tier taxonomy to categorize patterns flagged as 'AI-like'. This taxonomy helps users decide whether to accept a rewrite, defend a stylistic choice, or audit a detector's false positive.

    The Three Tiers

    1. Forensic (Undefendable): Real leakage from models or prompt templates. These are accidental artifacts that no human produces.

      • Examples: oaicite markers, contentReference tokens, turn0search0 artifacts, knowledge-cutoff disclaimers, or [Your Name] placeholders.
      • Defense Strength: Zero.
    2. Strict (Corporate-speak): Real human patterns that are often banned by users to maintain a specific brand voice. They don't prove AI usage, but they are considered 'cheap' or cliché.

      • Examples: Words like leverage, utilize, harness, delve, foster, cultivate; filler adverbs (fundamentally, essentially); or cliché openers like "In today's fast-paced world."
      • Defense Strength: Medium (can be defended as professional vocabulary, but usually overridden by brand-voice requirements).
    3. Aesthetic (Overreach/Defendable): Patterns flagged because LLMs happen to use them, even though they are hallmarks of famous human writers. These often cause false positives in detectors.

      • Examples: Em dashes (Emily Dickinson), the rule of three (Lincoln), passive voice (scientific writing), or the word "robust" (engineering/epidemiology).
      • Defense Strength: High.
  11. Understand the AI-Tell Rule Tiers

    main

    The linkedin-humanizer uses a three-tier classification system to identify and manage signals that AI detectors (like OriginalityAI or GPTZero) use to flag content as AI-generated. Understanding these tiers helps in deciding which writing patterns to modify and which to defend.

    Tier 1: Forensic (Real AI Signals)

    These are definitive markers of LLM generation. They have zero defense strength because they are technical artifacts of how AI models function or output data.

    • Examples: oaicite / contentReference / turn0search0 markers, knowledge-cutoff disclaimers, unfilled phrasal templates (e.g., [Your Name]), Mad-Libs style blanks, and extreme em-dash overuse (3+ in a single short post).

    Tier 2: Strict (Corporate-speak, Easy Ban)

    These are stylistic patterns common in LLM outputs that are frequently used in corporate or influencer writing. They have low to medium defense strength.

    • Examples: Specific AI vocabulary (e.g., leverage, utilize, harness, delve), filler adverbs (fundamentally, essentially), and cliché openers ("In today's fast-paced world").

    Tier 3: Aesthetic (Overreach, Defendable)

    These are standard human rhetorical or typographic patterns that AI detectors often incorrectly flag. They have high defense strength because they are foundational to human literature, science, and professional tools.

    • Examples: Single em-dash use, the 'Rule of Three', passive voice in technical contexts, specific technical terms like robust, and curly quotes (smart quotes).
  12. Understand LinkedIn thread flattening for replies

    main
    LinkedIn flattens reply threads to a maximum of 2 levels. When using the library to reply to a reply, you must ensure that the parentComment parameter points to the top-level comment URN, rather than the URN of the specific reply you are responding to. The linkedin-reply-handler skill is designed to manage this logic automatically.