From 5c20280648a7db592327981cdf48ac0304836ae6 Mon Sep 17 00:00:00 2001 From: D4rkgh057 Date: Wed, 4 Nov 2026 12:24:22 -0500 Subject: [PATCH] chore(skills): add license and author metadata, move long sections to references Adds license and metadata.author to the frontmatter of all 12 skills. Moves the V3 changelog out of linkedin-humanizer and the 2026 reach caveats out of linkedin-post-writer into their references/, leaving a pointer in each SKILL.md. Regenerated the Codex package with scripts/sync_codex_marketplace.py. No version bump. --- .../skills/linkedin-comment-drafter/SKILL.md | 3 +++ .../skills/linkedin-content-planner/SKILL.md | 3 +++ .../skills/linkedin-employee-advocacy/SKILL.md | 3 +++ .../skills/linkedin-engager-analytics/SKILL.md | 3 +++ .../skills/linkedin-hook-extractor/SKILL.md | 3 +++ .../skills/linkedin-humanizer/SKILL.md | 14 ++++---------- .../linkedin-humanizer/references/v3-changes.md | 12 ++++++++++++ .../skills/linkedin-interviewer/SKILL.md | 3 +++ .../skills/linkedin-post-writer/SKILL.md | 14 ++++---------- .../references/reach-caveats-2026.md | 12 ++++++++++++ .../skills/linkedin-profile-optimizer/SKILL.md | 3 +++ .../skills/linkedin-reply-handler/SKILL.md | 3 +++ .../skills/linkedin-repurposer/SKILL.md | 3 +++ .../skills/linkedin-thread-monitor/SKILL.md | 3 +++ skills/linkedin-comment-drafter/SKILL.md | 3 +++ skills/linkedin-content-planner/SKILL.md | 3 +++ skills/linkedin-employee-advocacy/SKILL.md | 3 +++ skills/linkedin-engager-analytics/SKILL.md | 3 +++ skills/linkedin-hook-extractor/SKILL.md | 3 +++ skills/linkedin-humanizer/SKILL.md | 14 ++++---------- skills/linkedin-humanizer/references/v3-changes.md | 12 ++++++++++++ skills/linkedin-interviewer/SKILL.md | 3 +++ skills/linkedin-post-writer/SKILL.md | 14 ++++---------- .../references/reach-caveats-2026.md | 12 ++++++++++++ skills/linkedin-profile-optimizer/SKILL.md | 3 +++ skills/linkedin-reply-handler/SKILL.md | 3 +++ skills/linkedin-repurposer/SKILL.md | 3 +++ skills/linkedin-thread-monitor/SKILL.md | 3 +++ 28 files changed, 124 insertions(+), 40 deletions(-) create mode 100644 .codex-marketplace/linkedin-skills/skills/linkedin-humanizer/references/v3-changes.md create mode 100644 .codex-marketplace/linkedin-skills/skills/linkedin-post-writer/references/reach-caveats-2026.md create mode 100644 skills/linkedin-humanizer/references/v3-changes.md create mode 100644 skills/linkedin-post-writer/references/reach-caveats-2026.md diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-comment-drafter/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-comment-drafter/SKILL.md index 3e217ed..84d84a3 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-comment-drafter/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-comment-drafter/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-comment-drafter description: "Draft a LinkedIn comment on someone else's post from its URL, or reshare (repost) it to your feed with optional commentary. Use when the user pastes a post URL and asks to comment, engage, be first commenter, or repost with their thoughts. Produces 1-3 variants in the user's voice, picks a reaction, and publishes via Publora on approval. Not for replying to existing comments (use linkedin-reply-handler)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Comment Drafter diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-content-planner/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-content-planner/SKILL.md index 48a49ed..86a9e14 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-content-planner/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-content-planner/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-content-planner description: "Generate a 7-day LinkedIn content plan from a theme, audience, and pillars. Produces per-day post pillar, format, hook type, CTA, posting time, daily comment targets, and a weekly inbound-readiness check. Use when the user wants to plan a week or month of content, not draft a single post (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Content Planner diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-employee-advocacy/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-employee-advocacy/SKILL.md index dba187e..739320e 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-employee-advocacy/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-employee-advocacy/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-employee-advocacy description: "Stand up and run a LinkedIn employee advocacy program for a marketing or sales team. Covers 14-day launch playbook, brand-guideline governance, per-post time budget, cadence benchmarks, and team ROI (reach, engagement, pipeline). Triggers on \"employee advocacy\", \"get the team posting\", \"scale LinkedIn across team\", \"advocacy ROI\". Not for planning one person's own calendar (use linkedin-content-planner)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Employee Advocacy diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-engager-analytics/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-engager-analytics/SKILL.md index 9fe5a09..3c734e0 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-engager-analytics/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-engager-analytics/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-engager-analytics description: "Pull the people who liked or commented on any LinkedIn post and segment them by ICP fit (peer / aspirational / prospect / other). Produces an engager roster, tier breakdown, and outbound action lists (follow back, comment-drop, DM-able with one-line openers). Powered by Apify, no LinkedIn login. Triggers on \"who liked my post\", \"who engaged\", \"engagers report\", \"audience analytics\". Not for tracking author replies to your comments (use linkedin-thread-monitor)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Engager Analytics diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-hook-extractor/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-hook-extractor/SKILL.md index 661bb9c..176d64a 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-hook-extractor/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-hook-extractor/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-hook-extractor description: "Reverse-engineer the hook formula from a viral LinkedIn post URL. Returns which of the 20 canonical 2026 formulas it uses (anaphora, R.I.P., year-pivot, time-anchor, curiosity-gap, contrarian, comment-gate, emotional cold-open, named-gratitude, and 11 more), why it worked, and a blank template. Use to learn from a competitor's post, not to write your own (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Hook Extractor diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/SKILL.md index ff78862..8bd1d1e 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-humanizer description: "Remove AI tells from LinkedIn posts/comments: 2026 vocabulary density, reveal bridges, staccato fragments, stacked triads, performed sincerity. Tiered rewriter plus `--mode audit` LinkedIn post auditor and `--mode profile` voice builder. Not for drafting from scratch (use linkedin-post-writer) or beating AI detectors. Keywords: humanize, de-AI, post audit, post auditor, audit before posting." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Humanizer V3 @@ -11,16 +14,7 @@ Rewrites any text to remove the AI tells that human readers notice and that Link ## What changed in V3 -Evidence tier in brackets: [strong] = replicated across 2+ independent 2025-2026 studies or our own length-controlled corpus; [vendor] = single platform or vendor dataset; [weak] = one study or expert-panel report. - -- **Vocabulary moved from a delete-list to density scoring.** The 2023-24 words (delve, tapestry, realm, journey) are decaying as humans avoid them [strong: Geng & Trotta 2025]. The durable 2026 markers are common words (significant, crucial, notably, comprehensive, insights, robust, leverage, foster, landscape, nuanced, streamline, elevate) plus grammar: nominalisations and "-ing" clause openers at 5.3x human rate [strong: Kobak Sci Adv 2025; Wu et al 2026; PNAS 2025]. AI vocabulary is also the one marker consistently reach-negative on LinkedIn in our own corpus (0.74-0.84 author-relative) [strong]. One marker in a paragraph is not a verdict. Three or more is. -- **Em dash is no longer a tell.** GPT-5.4 emits 1.43 per 1,000 words, below the 3.23 human baseline; 29% of human captions and 23% of top-creator LinkedIn posts in our corpus use one (author-relative ratio 1.09) [strong]. Zero em dashes is now its own tell (the writer is trying to look human). New rule: cap at about 1 per 100 words, replace excess with comma, colon, parentheses or a rewrite. Never a period. -- **Forced burstiness is the #1 2026 tell, not the fix.** LLM sentence-length variance is half of human [strong], but detectors do not score it, mechanical long/short alternation is a learnable humanizer fingerprint [weak: DAMAGE 2025], and on LinkedIn sentence-length variance is not an engagement lever in either direction (our corpus, n=397, within-creator: null to slightly negative) [strong]. "Short. Punchy. Done.", "No X. No Y. Just Z.", one-word paragraphs and "The result?" reveals are the current top tells. Pass 2 is now RHYTHM, not BREAK: fix machine-flat rhythm, never manufacture variance. -- **Rule of three is still a tell, at density.** Tricolon runs at 2x expert-human rate across 2026 frontier models [strong: arXiv 2604.19768]. Stacked, perfectly parallel triads and 3+ per post get scrubbed. One natural triple stays (26% of top human tweets have one). -- **Fingerprint injection was half wrong.** Named entities and concreteness are supported [strong: lower entity density in LLM text across 3 studies]; an odd-precision number with a referent in line 1 lifts likes 34% [vendor]. Bare numbers are not a discriminator, and inserted hedges and confessions backfire: performed hesitancy is 2x more common in LLM text than expert human text, and sincerity announcements ("let me be honest") are a named 2026 tell [strong: tropes.fyi false vulnerability; Schilke & Reimann 2025]. Pass 3 now asks for a flat, dated, uncomfortable fact instead. -- **Over-correction guard.** Humanizer output has its own fingerprint; "writing slightly worse on purpose" now reads as a tell [weak: DAMAGE 2025; slopotron]. Pass 4 checks whether Passes 1-3 introduced the very patterns they were meant to remove. Edits are proportional to real problems. When in doubt, leave it. - -See `sub-skills/rules-explainer.md` for per-rule justification, defenses, and citations, and `references/tier-rationale.md` §V3 for the evidence. +Load `references/v3-changes.md` for the V3 evidence tiers and rationale. Pass behaviour is defined in "The four passes" below. ## When to use diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/references/v3-changes.md b/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/references/v3-changes.md new file mode 100644 index 0000000..5ab9ae8 --- /dev/null +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-humanizer/references/v3-changes.md @@ -0,0 +1,12 @@ +# What changed in V3 + +Evidence tier in brackets: [strong] = replicated across 2+ independent 2025-2026 studies or our own length-controlled corpus; [vendor] = single platform or vendor dataset; [weak] = one study or expert-panel report. + +- **Vocabulary moved from a delete-list to density scoring.** The 2023-24 words (delve, tapestry, realm, journey) are decaying as humans avoid them [strong: Geng & Trotta 2025]. The durable 2026 markers are common words (significant, crucial, notably, comprehensive, insights, robust, leverage, foster, landscape, nuanced, streamline, elevate) plus grammar: nominalisations and "-ing" clause openers at 5.3x human rate [strong: Kobak Sci Adv 2025; Wu et al 2026; PNAS 2025]. AI vocabulary is also the one marker consistently reach-negative on LinkedIn in our own corpus (0.74-0.84 author-relative) [strong]. One marker in a paragraph is not a verdict. Three or more is. +- **Em dash is no longer a tell.** GPT-5.4 emits 1.43 per 1,000 words, below the 3.23 human baseline; 29% of human captions and 23% of top-creator LinkedIn posts in our corpus use one (author-relative ratio 1.09) [strong]. Zero em dashes is now its own tell (the writer is trying to look human). New rule: cap at about 1 per 100 words, replace excess with comma, colon, parentheses or a rewrite. Never a period. +- **Forced burstiness is the #1 2026 tell, not the fix.** LLM sentence-length variance is half of human [strong], but detectors do not score it, mechanical long/short alternation is a learnable humanizer fingerprint [weak: DAMAGE 2025], and on LinkedIn sentence-length variance is not an engagement lever in either direction (our corpus, n=397, within-creator: null to slightly negative) [strong]. "Short. Punchy. Done.", "No X. No Y. Just Z.", one-word paragraphs and "The result?" reveals are the current top tells. Pass 2 is now RHYTHM, not BREAK: fix machine-flat rhythm, never manufacture variance. +- **Rule of three is still a tell, at density.** Tricolon runs at 2x expert-human rate across 2026 frontier models [strong: arXiv 2604.19768]. Stacked, perfectly parallel triads and 3+ per post get scrubbed. One natural triple stays (26% of top human tweets have one). +- **Fingerprint injection was half wrong.** Named entities and concreteness are supported [strong: lower entity density in LLM text across 3 studies]; an odd-precision number with a referent in line 1 lifts likes 34% [vendor]. Bare numbers are not a discriminator, and inserted hedges and confessions backfire: performed hesitancy is 2x more common in LLM text than expert human text, and sincerity announcements ("let me be honest") are a named 2026 tell [strong: tropes.fyi false vulnerability; Schilke & Reimann 2025]. Pass 3 now asks for a flat, dated, uncomfortable fact instead. +- **Over-correction guard.** Humanizer output has its own fingerprint; "writing slightly worse on purpose" now reads as a tell [weak: DAMAGE 2025; slopotron]. Pass 4 checks whether Passes 1-3 introduced the very patterns they were meant to remove. Edits are proportional to real problems. When in doubt, leave it. + +See `../sub-skills/rules-explainer.md` for per-rule justification, defenses, and citations, and `tier-rationale.md` §V3 for the evidence. diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-interviewer/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-interviewer/SKILL.md index 9194a04..ffab4f6 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-interviewer/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-interviewer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-interviewer description: "Interview the user for the raw material their posts are made of. Builds a lasting Story Bank of roles, numbers, turning points, scars and positions, or runs a focused interview that turns one topic into a post spine. Use when a draft has nothing concrete to draw on, or the user says interview me. Not for learning how they write (use linkedin-humanizer --mode profile)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Interviewer diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/SKILL.md index 5488753..1b58bcf 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/SKILL.md @@ -1,6 +1,9 @@ --- name: 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)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Post Writer @@ -47,16 +50,7 @@ Full skeletons in `../../references/hook-formulas.md`. F1-F10 are the long-form ### 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). +Read `references/reach-caveats-2026.md` before choosing a formula: it lists which formulas need care in 2026 (F4, F6, F9, F12, F18), the number-first and no-question-opener rules, and the density rule. ### Pick by goal first diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/references/reach-caveats-2026.md b/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/references/reach-caveats-2026.md new file mode 100644 index 0000000..d086975 --- /dev/null +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-post-writer/references/reach-caveats-2026.md @@ -0,0 +1,12 @@ +# 2026 reach caveats (Sep 2026 audit) + +The reference numbers in the formula table of SKILL.md 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). diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-profile-optimizer/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-profile-optimizer/SKILL.md index edde0b1..fdc33b6 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-profile-optimizer/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-profile-optimizer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-profile-optimizer description: "Audit and rewrite a LinkedIn profile end-to-end for 2026: headline, About 7-step, Featured, banner, photo, Experience metrics, Skills, custom URL, recommendations. Triggers on \"review my profile\", \"rewrite my headline\", \"fix my About\", \"optimize banner\", \"profile audit\", \"LinkedIn bio\". Converts resume-style profiles to ones that convert 3-5x better. Not for writing feed content (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Profile Optimizer diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-reply-handler/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-reply-handler/SKILL.md index 838f501..20b199e 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-reply-handler/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-reply-handler/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-reply-handler description: "Draft a reply to one LinkedIn comment from its URL, or sweep a whole thread from just the post URL and draft a reply to every comment worth answering, in one batch. Use for replying to a comment, following an author reply, or clearing all comments on a post. Resolves the correct parentComment (LinkedIn flattens threads to 2 levels), filters low-value comments before a sweep, and posts via Publora on approval. Not for top-level comments (use linkedin-comment-drafter)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Reply Handler diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-repurposer/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-repurposer/SKILL.md index a0db283..b22d1a2 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-repurposer/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-repurposer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-repurposer description: "Repurpose existing content into a native LinkedIn post. Take a tweet, thread, YouTube video, blog, or newsletter and rebuild it for LinkedIn: re-hook before the fold, expand to the 900 to 1300 char sweet spot, add whitespace and a CTA, move links to the first comment, run the humanizer, publish via Publora on approval. Not for writing from scratch (use linkedin-post-writer), not for auditing a draft (use linkedin-humanizer --mode audit)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Repurposer diff --git a/.codex-marketplace/linkedin-skills/skills/linkedin-thread-monitor/SKILL.md b/.codex-marketplace/linkedin-skills/skills/linkedin-thread-monitor/SKILL.md index ab6335f..9f63762 100644 --- a/.codex-marketplace/linkedin-skills/skills/linkedin-thread-monitor/SKILL.md +++ b/.codex-marketplace/linkedin-skills/skills/linkedin-thread-monitor/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-thread-monitor description: "Track which of your LinkedIn comments earned author replies. Flags the 6-24h warm-reply window where thread momentum peaks, classifies threads as hot/warm/cool/dormant, and routes warm ones to linkedin-reply-handler for follow-up drafts. Powered by Apify, no LinkedIn login. Triggers on \"what threads need follow-up\", \"author replied\", \"monitor my comments\". Not for analyzing likers on a post (use linkedin-engager-analytics)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Thread Monitor diff --git a/skills/linkedin-comment-drafter/SKILL.md b/skills/linkedin-comment-drafter/SKILL.md index 3e217ed..84d84a3 100644 --- a/skills/linkedin-comment-drafter/SKILL.md +++ b/skills/linkedin-comment-drafter/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-comment-drafter description: "Draft a LinkedIn comment on someone else's post from its URL, or reshare (repost) it to your feed with optional commentary. Use when the user pastes a post URL and asks to comment, engage, be first commenter, or repost with their thoughts. Produces 1-3 variants in the user's voice, picks a reaction, and publishes via Publora on approval. Not for replying to existing comments (use linkedin-reply-handler)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Comment Drafter diff --git a/skills/linkedin-content-planner/SKILL.md b/skills/linkedin-content-planner/SKILL.md index 48a49ed..86a9e14 100644 --- a/skills/linkedin-content-planner/SKILL.md +++ b/skills/linkedin-content-planner/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-content-planner description: "Generate a 7-day LinkedIn content plan from a theme, audience, and pillars. Produces per-day post pillar, format, hook type, CTA, posting time, daily comment targets, and a weekly inbound-readiness check. Use when the user wants to plan a week or month of content, not draft a single post (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Content Planner diff --git a/skills/linkedin-employee-advocacy/SKILL.md b/skills/linkedin-employee-advocacy/SKILL.md index dba187e..739320e 100644 --- a/skills/linkedin-employee-advocacy/SKILL.md +++ b/skills/linkedin-employee-advocacy/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-employee-advocacy description: "Stand up and run a LinkedIn employee advocacy program for a marketing or sales team. Covers 14-day launch playbook, brand-guideline governance, per-post time budget, cadence benchmarks, and team ROI (reach, engagement, pipeline). Triggers on \"employee advocacy\", \"get the team posting\", \"scale LinkedIn across team\", \"advocacy ROI\". Not for planning one person's own calendar (use linkedin-content-planner)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Employee Advocacy diff --git a/skills/linkedin-engager-analytics/SKILL.md b/skills/linkedin-engager-analytics/SKILL.md index 9fe5a09..3c734e0 100644 --- a/skills/linkedin-engager-analytics/SKILL.md +++ b/skills/linkedin-engager-analytics/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-engager-analytics description: "Pull the people who liked or commented on any LinkedIn post and segment them by ICP fit (peer / aspirational / prospect / other). Produces an engager roster, tier breakdown, and outbound action lists (follow back, comment-drop, DM-able with one-line openers). Powered by Apify, no LinkedIn login. Triggers on \"who liked my post\", \"who engaged\", \"engagers report\", \"audience analytics\". Not for tracking author replies to your comments (use linkedin-thread-monitor)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Engager Analytics diff --git a/skills/linkedin-hook-extractor/SKILL.md b/skills/linkedin-hook-extractor/SKILL.md index 661bb9c..176d64a 100644 --- a/skills/linkedin-hook-extractor/SKILL.md +++ b/skills/linkedin-hook-extractor/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-hook-extractor description: "Reverse-engineer the hook formula from a viral LinkedIn post URL. Returns which of the 20 canonical 2026 formulas it uses (anaphora, R.I.P., year-pivot, time-anchor, curiosity-gap, contrarian, comment-gate, emotional cold-open, named-gratitude, and 11 more), why it worked, and a blank template. Use to learn from a competitor's post, not to write your own (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Hook Extractor diff --git a/skills/linkedin-humanizer/SKILL.md b/skills/linkedin-humanizer/SKILL.md index ff78862..8bd1d1e 100644 --- a/skills/linkedin-humanizer/SKILL.md +++ b/skills/linkedin-humanizer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-humanizer description: "Remove AI tells from LinkedIn posts/comments: 2026 vocabulary density, reveal bridges, staccato fragments, stacked triads, performed sincerity. Tiered rewriter plus `--mode audit` LinkedIn post auditor and `--mode profile` voice builder. Not for drafting from scratch (use linkedin-post-writer) or beating AI detectors. Keywords: humanize, de-AI, post audit, post auditor, audit before posting." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Humanizer V3 @@ -11,16 +14,7 @@ Rewrites any text to remove the AI tells that human readers notice and that Link ## What changed in V3 -Evidence tier in brackets: [strong] = replicated across 2+ independent 2025-2026 studies or our own length-controlled corpus; [vendor] = single platform or vendor dataset; [weak] = one study or expert-panel report. - -- **Vocabulary moved from a delete-list to density scoring.** The 2023-24 words (delve, tapestry, realm, journey) are decaying as humans avoid them [strong: Geng & Trotta 2025]. The durable 2026 markers are common words (significant, crucial, notably, comprehensive, insights, robust, leverage, foster, landscape, nuanced, streamline, elevate) plus grammar: nominalisations and "-ing" clause openers at 5.3x human rate [strong: Kobak Sci Adv 2025; Wu et al 2026; PNAS 2025]. AI vocabulary is also the one marker consistently reach-negative on LinkedIn in our own corpus (0.74-0.84 author-relative) [strong]. One marker in a paragraph is not a verdict. Three or more is. -- **Em dash is no longer a tell.** GPT-5.4 emits 1.43 per 1,000 words, below the 3.23 human baseline; 29% of human captions and 23% of top-creator LinkedIn posts in our corpus use one (author-relative ratio 1.09) [strong]. Zero em dashes is now its own tell (the writer is trying to look human). New rule: cap at about 1 per 100 words, replace excess with comma, colon, parentheses or a rewrite. Never a period. -- **Forced burstiness is the #1 2026 tell, not the fix.** LLM sentence-length variance is half of human [strong], but detectors do not score it, mechanical long/short alternation is a learnable humanizer fingerprint [weak: DAMAGE 2025], and on LinkedIn sentence-length variance is not an engagement lever in either direction (our corpus, n=397, within-creator: null to slightly negative) [strong]. "Short. Punchy. Done.", "No X. No Y. Just Z.", one-word paragraphs and "The result?" reveals are the current top tells. Pass 2 is now RHYTHM, not BREAK: fix machine-flat rhythm, never manufacture variance. -- **Rule of three is still a tell, at density.** Tricolon runs at 2x expert-human rate across 2026 frontier models [strong: arXiv 2604.19768]. Stacked, perfectly parallel triads and 3+ per post get scrubbed. One natural triple stays (26% of top human tweets have one). -- **Fingerprint injection was half wrong.** Named entities and concreteness are supported [strong: lower entity density in LLM text across 3 studies]; an odd-precision number with a referent in line 1 lifts likes 34% [vendor]. Bare numbers are not a discriminator, and inserted hedges and confessions backfire: performed hesitancy is 2x more common in LLM text than expert human text, and sincerity announcements ("let me be honest") are a named 2026 tell [strong: tropes.fyi false vulnerability; Schilke & Reimann 2025]. Pass 3 now asks for a flat, dated, uncomfortable fact instead. -- **Over-correction guard.** Humanizer output has its own fingerprint; "writing slightly worse on purpose" now reads as a tell [weak: DAMAGE 2025; slopotron]. Pass 4 checks whether Passes 1-3 introduced the very patterns they were meant to remove. Edits are proportional to real problems. When in doubt, leave it. - -See `sub-skills/rules-explainer.md` for per-rule justification, defenses, and citations, and `references/tier-rationale.md` §V3 for the evidence. +Load `references/v3-changes.md` for the V3 evidence tiers and rationale. Pass behaviour is defined in "The four passes" below. ## When to use diff --git a/skills/linkedin-humanizer/references/v3-changes.md b/skills/linkedin-humanizer/references/v3-changes.md new file mode 100644 index 0000000..5ab9ae8 --- /dev/null +++ b/skills/linkedin-humanizer/references/v3-changes.md @@ -0,0 +1,12 @@ +# What changed in V3 + +Evidence tier in brackets: [strong] = replicated across 2+ independent 2025-2026 studies or our own length-controlled corpus; [vendor] = single platform or vendor dataset; [weak] = one study or expert-panel report. + +- **Vocabulary moved from a delete-list to density scoring.** The 2023-24 words (delve, tapestry, realm, journey) are decaying as humans avoid them [strong: Geng & Trotta 2025]. The durable 2026 markers are common words (significant, crucial, notably, comprehensive, insights, robust, leverage, foster, landscape, nuanced, streamline, elevate) plus grammar: nominalisations and "-ing" clause openers at 5.3x human rate [strong: Kobak Sci Adv 2025; Wu et al 2026; PNAS 2025]. AI vocabulary is also the one marker consistently reach-negative on LinkedIn in our own corpus (0.74-0.84 author-relative) [strong]. One marker in a paragraph is not a verdict. Three or more is. +- **Em dash is no longer a tell.** GPT-5.4 emits 1.43 per 1,000 words, below the 3.23 human baseline; 29% of human captions and 23% of top-creator LinkedIn posts in our corpus use one (author-relative ratio 1.09) [strong]. Zero em dashes is now its own tell (the writer is trying to look human). New rule: cap at about 1 per 100 words, replace excess with comma, colon, parentheses or a rewrite. Never a period. +- **Forced burstiness is the #1 2026 tell, not the fix.** LLM sentence-length variance is half of human [strong], but detectors do not score it, mechanical long/short alternation is a learnable humanizer fingerprint [weak: DAMAGE 2025], and on LinkedIn sentence-length variance is not an engagement lever in either direction (our corpus, n=397, within-creator: null to slightly negative) [strong]. "Short. Punchy. Done.", "No X. No Y. Just Z.", one-word paragraphs and "The result?" reveals are the current top tells. Pass 2 is now RHYTHM, not BREAK: fix machine-flat rhythm, never manufacture variance. +- **Rule of three is still a tell, at density.** Tricolon runs at 2x expert-human rate across 2026 frontier models [strong: arXiv 2604.19768]. Stacked, perfectly parallel triads and 3+ per post get scrubbed. One natural triple stays (26% of top human tweets have one). +- **Fingerprint injection was half wrong.** Named entities and concreteness are supported [strong: lower entity density in LLM text across 3 studies]; an odd-precision number with a referent in line 1 lifts likes 34% [vendor]. Bare numbers are not a discriminator, and inserted hedges and confessions backfire: performed hesitancy is 2x more common in LLM text than expert human text, and sincerity announcements ("let me be honest") are a named 2026 tell [strong: tropes.fyi false vulnerability; Schilke & Reimann 2025]. Pass 3 now asks for a flat, dated, uncomfortable fact instead. +- **Over-correction guard.** Humanizer output has its own fingerprint; "writing slightly worse on purpose" now reads as a tell [weak: DAMAGE 2025; slopotron]. Pass 4 checks whether Passes 1-3 introduced the very patterns they were meant to remove. Edits are proportional to real problems. When in doubt, leave it. + +See `../sub-skills/rules-explainer.md` for per-rule justification, defenses, and citations, and `tier-rationale.md` §V3 for the evidence. diff --git a/skills/linkedin-interviewer/SKILL.md b/skills/linkedin-interviewer/SKILL.md index 9194a04..ffab4f6 100644 --- a/skills/linkedin-interviewer/SKILL.md +++ b/skills/linkedin-interviewer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-interviewer description: "Interview the user for the raw material their posts are made of. Builds a lasting Story Bank of roles, numbers, turning points, scars and positions, or runs a focused interview that turns one topic into a post spine. Use when a draft has nothing concrete to draw on, or the user says interview me. Not for learning how they write (use linkedin-humanizer --mode profile)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Interviewer diff --git a/skills/linkedin-post-writer/SKILL.md b/skills/linkedin-post-writer/SKILL.md index 5488753..1b58bcf 100644 --- a/skills/linkedin-post-writer/SKILL.md +++ b/skills/linkedin-post-writer/SKILL.md @@ -1,6 +1,9 @@ --- name: 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)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Post Writer @@ -47,16 +50,7 @@ Full skeletons in `../../references/hook-formulas.md`. F1-F10 are the long-form ### 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). +Read `references/reach-caveats-2026.md` before choosing a formula: it lists which formulas need care in 2026 (F4, F6, F9, F12, F18), the number-first and no-question-opener rules, and the density rule. ### Pick by goal first diff --git a/skills/linkedin-post-writer/references/reach-caveats-2026.md b/skills/linkedin-post-writer/references/reach-caveats-2026.md new file mode 100644 index 0000000..d086975 --- /dev/null +++ b/skills/linkedin-post-writer/references/reach-caveats-2026.md @@ -0,0 +1,12 @@ +# 2026 reach caveats (Sep 2026 audit) + +The reference numbers in the formula table of SKILL.md 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). diff --git a/skills/linkedin-profile-optimizer/SKILL.md b/skills/linkedin-profile-optimizer/SKILL.md index edde0b1..fdc33b6 100644 --- a/skills/linkedin-profile-optimizer/SKILL.md +++ b/skills/linkedin-profile-optimizer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-profile-optimizer description: "Audit and rewrite a LinkedIn profile end-to-end for 2026: headline, About 7-step, Featured, banner, photo, Experience metrics, Skills, custom URL, recommendations. Triggers on \"review my profile\", \"rewrite my headline\", \"fix my About\", \"optimize banner\", \"profile audit\", \"LinkedIn bio\". Converts resume-style profiles to ones that convert 3-5x better. Not for writing feed content (use linkedin-post-writer)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Profile Optimizer diff --git a/skills/linkedin-reply-handler/SKILL.md b/skills/linkedin-reply-handler/SKILL.md index 838f501..20b199e 100644 --- a/skills/linkedin-reply-handler/SKILL.md +++ b/skills/linkedin-reply-handler/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-reply-handler description: "Draft a reply to one LinkedIn comment from its URL, or sweep a whole thread from just the post URL and draft a reply to every comment worth answering, in one batch. Use for replying to a comment, following an author reply, or clearing all comments on a post. Resolves the correct parentComment (LinkedIn flattens threads to 2 levels), filters low-value comments before a sweep, and posts via Publora on approval. Not for top-level comments (use linkedin-comment-drafter)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Reply Handler diff --git a/skills/linkedin-repurposer/SKILL.md b/skills/linkedin-repurposer/SKILL.md index a0db283..b22d1a2 100644 --- a/skills/linkedin-repurposer/SKILL.md +++ b/skills/linkedin-repurposer/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-repurposer description: "Repurpose existing content into a native LinkedIn post. Take a tweet, thread, YouTube video, blog, or newsletter and rebuild it for LinkedIn: re-hook before the fold, expand to the 900 to 1300 char sweet spot, add whitespace and a CTA, move links to the first comment, run the humanizer, publish via Publora on approval. Not for writing from scratch (use linkedin-post-writer), not for auditing a draft (use linkedin-humanizer --mode audit)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Repurposer diff --git a/skills/linkedin-thread-monitor/SKILL.md b/skills/linkedin-thread-monitor/SKILL.md index ab6335f..9f63762 100644 --- a/skills/linkedin-thread-monitor/SKILL.md +++ b/skills/linkedin-thread-monitor/SKILL.md @@ -1,6 +1,9 @@ --- name: linkedin-thread-monitor description: "Track which of your LinkedIn comments earned author replies. Flags the 6-24h warm-reply window where thread momentum peaks, classifies threads as hot/warm/cool/dormant, and routes warm ones to linkedin-reply-handler for follow-up drafts. Powered by Apify, no LinkedIn login. Triggers on \"what threads need follow-up\", \"author replied\", \"monitor my comments\". Not for analyzing likers on a post (use linkedin-engager-analytics)." +license: MIT +metadata: + author: Sergey Bulaev --- # LinkedIn Thread Monitor