linkedin-marketing

Files (152)

• plugin.json · .codex-plugin/
• .codexignore
• .env.example
• LICENSE
• README.md
• SECURITY.md
• SKILL.md
• icon.svg · assets/
• linkedin-skills-hero.png · assets/
• social-preview.png · assets/
• __init__.py · lib/
• _env.py · lib/
• apify_client.py · lib/
• approval.py · lib/
• backend_selector.py · lib/
• pixfaro_client.py · lib/
• publora_client.py · lib/
• url_parser.py · lib/
• algorithm-heuristics.md · references/
• engagement-metrics-taxonomy.md · references/
• founder-topics.md · references/
• hook-formulas.md · references/
• industry-benchmarks.md · references/
• job-log.md · references/
• operator-codesbyfebin.md · references/
• story-bank.md · references/
• untrusted-content.md · references/
• voice-profile.md · references/
• voice-rules.md · references/
• requirements-lock.txt
• requirements.txt
• approval_gate.py · scripts/
• check_actor_inputs.py · scripts/
• check_config.py · scripts/
• check_frontmatter.py · scripts/
• check_no_secrets.py · scripts/
• job_fit.py · scripts/
• post_comment.py · scripts/
• schedule_post.py · scripts/
• selftest.py · scripts/
• SKILL.md · skills/agent-instagram-desk/
• checklist.md · skills/agent-instagram-desk/references/
• SKILL.md · skills/agent-whatsapp-desk/
• checklist.md · skills/agent-whatsapp-desk/references/
• SKILL.md · skills/agent-x-desk/
• checklist.md · skills/agent-x-desk/references/
• SKILL.md · skills/agent-youtube-desk/
• checklist.md · skills/agent-youtube-desk/references/
• SKILL.md · skills/linkedin-analytics-review/
• checklist.md · skills/linkedin-analytics-review/references/
• SKILL.md · skills/linkedin-approval-gate/
• checklist.md · skills/linkedin-approval-gate/references/
• SKILL.md · skills/linkedin-carousel-writer/
• checklist.md · skills/linkedin-carousel-writer/references/
• SKILL.md · skills/linkedin-case-receipt/
• checklist.md · skills/linkedin-case-receipt/references/
• SKILL.md · skills/linkedin-comment-drafter/
• comment-templates.md · skills/linkedin-comment-drafter/references/
• examples.md · skills/linkedin-comment-drafter/references/
• voice-rules.md · skills/linkedin-comment-drafter/references/
• …and 92 more

SKILL.md (first lines)

# LinkedIn Marketing Skills

A bundle of 40 focused skills for LinkedIn content ops in 2026, built for Claude Code and Codex. Each skill is single-purpose, follows the draft → approval → publish pattern, and uses the [Publora API](https://publora.com) for posting.

## When to use this bundle

- **Writing a viral post** → use `linkedin-post-writer`
- **Commenting on someone else's post** → use `linkedin-comment-drafter`
- **Replying to a comment** (yours or someone else's), or sweeping and replying to an entire comment thread from just the post URL → use `linkedin-reply-handler`
- **Reviewing a draft before publishing, removing AI tells, scoring AI emoji density, defending a flagged rule, or running 5 AI detectors in parallel** → use `linkedin-humanizer` (rewrite + `--mode audit` pre-publish review; folds in the former post-audit, emoji-detector, rules-explainer, and detector-tester sub-tools)
- **Extracting a hook formula from a viral post** → use `linkedin-hook-extractor`
- **Planning a week of LinkedIn content** → use `linkedin-content-planner`
- **Tracking which of your comments got author replies** → use `linkedin-thread-monitor`
- **Analyzing who liked / commented on any post (audience segmentation)** → use `linkedin-engager-analytics`
- **Auditing / rewriting a LinkedIn profile** → use `linkedin-profile-optimizer`
- **Running an employee advocacy program across a marketing team** → use `linkedin-employee-advocacy`
- **Adapting content from another platform (tweet, video, blog) into a native LinkedIn post** → use `linkedin-repurposer`
- **Working out what you actually have to say, or having nothing concrete for a draft to use** → use `linkedin-interviewer`. It interviews you and keeps the answers in `references/story-bank.md`, which every writing skill reads. Start here if you have never posted: the voice profile needs posts you already wrote, the Story Bank only needs a career.
- **Document or carousel** → use `linkedin-carousel-writer`
- **Newsletter issue** → use `linkedin-newsletter`
- **One connection note for a named person** → use `linkedin-connection-note` (refuses lists)
- **Read pasted analytics** → use `linkedin-analytics-review`
- **A 4 to 6 post series** → use `linkedin-series-builder`
- **A proof post from a build log** → use `linkedin-case-receipt`
- **Three closes for a finished draft** → use `linkedin-cta-lab`
- **A poll plus companion text** → use `linkedin-poll-writer`
- **Last check before publish** → use `linkedin-approval-gate`
- **Five headlines** → use `linkedin-headline-lab`
- **The comment that holds the link** → use `linkedin-first-comment`
- **Five openings for one claim** → use `linkedin-hook-lab`
- **A comment on one post you want to amplify** → use `linkedin-quote-comment`
- **A public correction** → use `linkedin-correction`
- **A talk or meetup note** → use `linkedin-event-note`
- **Four bullets for one role** → use `linkedin-experience-bullet`
- **What not to post** → use `linkedin-silence-audit`
- **An IST posting window** → use `linkedin-ist-window`
- **Three Featured pins** → use `linkedin-feature-picker`
- **File a pasted job** → use `linkedin-job-intake` (no scraping)
- **Score a role against your proof** → use `linkedin-job-fit`
- **One application note** → use `linkedin-job-note`
- **Form answers you paste yourself** → use `linkedin-job-answers`
- **Log a role you already submitted** → use `linkedin-job-log`
- **An X post** → use `agent-x-desk`
- **An Instagram caption** → use `agent-instagram-desk`
- **A YouTube title and description** → use `agent-youtube-desk`
- **One WhatsApp reply** → use `agent-whatsapp-desk`





## Founders edition

For founders building trust with investors, hires, and design partners, the bundle ships a dedicated founder layer:

- **`references/founder-topics.md`** — 10 founder content **angles** (A1-A10) as fill-in templates: reprice the category, content-to-pipeline, audience of one, the scarce-shots math, the unglamorous bet, the limit of delegation, designed serendipity, the evasive-sentence test, the delegation line, the learning gate. Each maps to a primary goal and a hook formula.
- **4 structural formulas (F17-F20)** in `references/hook-formulas.md` — controlled A/B anecdote, false-binary dissolve, anecdote-meets-evidence bridge, diverging-curves close. They shape a post's logic rather than its topic and back the founder angles.
- **A founders-edition pillar set** (Conviction / Building in public / The math / Proof) in `linkedin-content-planner`.

`linkedin-post-writer` offers a founder angle before picking a formula when the writer is a founder; `linkedin-content-planner` asks "founder plan or general plan?" and swaps the pillar set. The founder angles compound trust with a narrow, high-value audience instead of chasing broad reach.

## Core pattern

Every action-taking skill follows three steps:

1. **Parse the input.** User provides a LinkedIn URL (post or comment). The skill uses `lib/url_parser.py` to extract the post URN and any comment ID.
2. **Draft the content.** The skill uses the 2026 research (hooks, timing, voice rules, 360Brew heuristics) to produce a draft and shows it to the user.
3. **Wait for approval.** The user replies with "post", "yes", or suggests edits. Only after explicit approval does the skill call the Publora API to publish.

## Prerequisites

**Three tiers — pick one.**

### 🟢 Tier 0 — Draft only (default, no setup)

The skills work out of the box. No API keys, no signup. Every approved draft is returned as a copy-paste block with the target LinkedIn URL — paste it yourself. Great for trying the skills before committing to any backend.

### 🔵 Tier 1 — Publora auto-post (recommended, ~2 min)

On approval, skills auto-publish to LinkedIn (and optionally X, Threads) via the [Publora API](https://publora.com). Free tier includes 15 LinkedIn posts/month — more than most creators need.

**Two ways in.** On claude.ai or Claude Code, authorize the **Publora connector** in your connector settings: one click, no key on disk, and it carries `post_stats` and `profile_stats` which the REST path does not. Anywhere else, use the API key below. `scripts/check_config.py` reads `.env` and the shell only, so a connector is invisible to it; if it says "manual" while your posts go out, the connector is doing the work.

1. Sign up free: **https://app.publora.com/signup**
2. Connect your LinkedIn account in Publora (Channels → Add Channel)
3. Copy your API key from Publora's API panel
4. Drop into `.env`:
   ```
   PUBLORA_API_KEY=sk_...
   LINKEDIN_PLATFORM_ID=linkedin-...
   ```
5. Run `pip install -r requirements.txt`

Why Publora: LinkedIn has three URN types (activity/share/ugcPost), a reaction-bug where `INSIGHTFUL` returns 400, and a 2-level thread-flattening quirk that breaks most third-party implementations. Publora handles all of it. We built on top of their API so we didn't have to.

### ⚫ Tier 2 — Build your own poster (advanced)

Prefer not to SaaS it? Ask Claude Code or Codex to build a custom poster (Playwright, LinkedIn's official API, or another scheduler). Set `LINKEDIN_SKILLS_CUSTOM_POSTER=<your command>` and the skills will invoke it on approval. This is a weekend of work. Publora is 2 minutes.

### Optional: Apify (read-side LinkedIn fetching)

Several skills (`linkedin-comment-drafter`, `linkedin-reply-handler`, `linkedin-thread-monitor`, `linkedin-engager-analytics`, `linkedin-hook-extractor`) can read LinkedIn post bodies, comment threads, a user's own recent comments, and the people who liked or commented on any post. They use the Apify platform when an `APIFY_TOKEN` is set; otherwise they ask you to paste the relevant text.

1. Sign up free: **https://console.apify.com/sign-up** (free tier ships with $5/month of credit, enough for ~1,000 post fetches or ~1,000 comment-thread fetches).
2. Generate a token: Console → Settings → Integrations.
3. Drop into `.env`:
   ```
   APIFY_TOKEN=apify_api_...
   ```

Actors used (all no-cookies, public, no LinkedIn login required):

| Use case | Actor | Approx cost |
|---|---|---|
| Post body by URL | `supreme_coder/linkedin-post` | $1 / 1,000 |
| Comments + replies on a post | `apimaestro/linkedin-post-comments-replies-engagements-scraper-no-cookies` | $5 / 1,000 |
| Your own recent comments | `apimaestro/linkedin-profile-comments` | $5 / 1,000 |
| Likers + commenters on any post | `scraping_solutions/linkedin-posts-engagers-likers-and-commenters-no-cookies` | $5 / 1,000 |

From CodesbyFebin/linkedin-manager, MIT.

More from CodesbyFebin/linkedin-manager