From 3235c4f1669ede0dbdfe27f11056df0f1488ce21 Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Sat, 30 May 2026 01:05:19 +0200 Subject: [PATCH] docs(linkedin-studio): reconcile discoverability surfaces + skill naming MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Wave 3 / Step 12 of the remediation plan (Phase 1 — usable by a non-author). Fix the discoverability defects the audit flagged: - skills/linkedin-studio/SKILL.md (the auto-activating router): self-naming 'the LinkedIn thought leadership plugin' -> 'LinkedIn Studio' (v3.0 rename leftover); the 'All Agents' table corrected from 14 to the real 19 (added editorial-reviewer, voice-scrubber, content-reviewer, language-reviewer, fact-reviewer); the 'All Commands' table completed to 26 (added headless-review, pivot, carousel) so it routes to newsletter/headless-review/pivot/react. - commands/onboarding.md: '25 commands' -> '26 commands' (x2); pillar count '3-5 expertise areas' -> '5 expertise areas' (reconciles onboarding's 3-5 with setup.md's '5 core topics' and the CLAUDE.md '5 core expertise areas' rule). - commands/linkedin.md: router table + numbered option list gain headless-review and pivot. Scope note (operator decision, this session): the plan's Verify grep 'grep -rni "thought leadership" skills/ -> no matches' is broader than the brief's actual criterion (which targets only the router skill's self-naming). 'thought leadership' is a plugin-wide DOMAIN term — the '8 Thought Leadership Angles' framework lives in references/thought-leadership-angles.md and is referenced by ~40 files (glossary, agents, post/video/batch commands). Renaming it only inside skills/ would create cross-file inconsistency; renaming it plugin-wide is a separate vocabulary migration outside Step 12's discoverability scope. Per operator choice, the router SELF-NAMING is fixed (brief criterion met) and the 4 remaining skills/ hits (linkedin-content-creation headings + one linkedin-strategy phase cell) are legitimate domain usage kept consistent with the rest of the tree. setup.md needed no edit: its pillar number was already '5'; reconciliation was a one-sided fix in onboarding. Verify: router no longer says 'thought leadership plugin'; grep -nc 'headless-review' commands/linkedin.md -> 2; onboarding pillar count '5' matches setup.md; SKILL.md agent table 19 rows, command table 26 rows; structural lint exit 0 (61 passed). Co-Authored-By: Claude Opus 4.8 --- plugins/linkedin-studio/commands/linkedin.md | 4 ++++ plugins/linkedin-studio/commands/onboarding.md | 6 +++--- .../linkedin-studio/skills/linkedin-studio/SKILL.md | 12 ++++++++++-- 3 files changed, 17 insertions(+), 5 deletions(-) diff --git a/plugins/linkedin-studio/commands/linkedin.md b/plugins/linkedin-studio/commands/linkedin.md index 3248a54..67da103 100644 --- a/plugins/linkedin-studio/commands/linkedin.md +++ b/plugins/linkedin-studio/commands/linkedin.md @@ -79,6 +79,8 @@ Present these options to the user: | `/linkedin:carousel` | Create structured multi-slide carousel with visual layout guidance | | `/linkedin:video` | Create video scripts with hook, body, CTA, captions, and thumbnail suggestions | | `/linkedin:newsletter` | Long-form orchestrator — newsletter editions, essays, series articles (research → draft → fact-check → persona-review → lock → delivery). The single long-form entry point | +| `/linkedin:headless-review` | Cold adversarial review of a FROZEN long-form draft (argument, language, facts, reader-fit) — run before lock, ideally in a fresh session for max independence | +| `/linkedin:pivot` | Re-open a long-form edition after a substantive late change so cleared gates (fact-check → editorial → persona → headless) re-run before lock | | `/linkedin:batch` | Create a full week of content in one session | | `/linkedin:calendar` | View and manage your post scheduling queue + run the publish action (mark a scheduled post as published) | @@ -145,6 +147,8 @@ Use AskUserQuestion to ask: 20. **Create a video** — Script for talking head, screen recording, or slideshow 21. **Mark published** — I just published a scheduled post 22. **Write long-form** — Newsletter edition, essay, or series article (`/linkedin:newsletter`) +23. **Cold review (headless)** — Independent adversarial re-read of a frozen long-form draft before lock (`/linkedin:headless-review`) +24. **Pivot a long-form edition** — Re-open cleared gates after a late substantive change (`/linkedin:pivot`) Based on their answer, guide them to the appropriate command or invoke it directly. diff --git a/plugins/linkedin-studio/commands/onboarding.md b/plugins/linkedin-studio/commands/onboarding.md index 24952c3..4bc29de 100644 --- a/plugins/linkedin-studio/commands/onboarding.md +++ b/plugins/linkedin-studio/commands/onboarding.md @@ -3,7 +3,7 @@ name: linkedin:onboarding description: | Multi-step onboarding wizard that guides new users through profile → setup → first-post as one cohesive flow. Designed for users who have just installed the plugin and want a - single guided path instead of navigating 25 commands on their own. + single guided path instead of navigating 26 commands on their own. Triggers on: "onboarding", "get started", "new user", "setup wizard", "start from scratch", "just installed", "how do I start", "walk me through", "linkedin onboarding". allowed-tools: @@ -151,7 +151,7 @@ file must contain no ``. 1. Full name 2. Industry 3. Job title / role -4. 3-5 expertise areas (these become your content pillars) +4. 5 expertise areas (these become your content pillars) 5. Target audience description Save to `config/user-profile.local.md`. @@ -214,4 +214,4 @@ First post: [Published DATE / Pending — run /linkedin:first-post] - `/linkedin:batch` — Plan a full week of content in one session - `/linkedin:react` — Turn articles and news into posts - `/linkedin:strategy` — Growth strategy tailored to your follower level -- `/linkedin` — See all 25 commands anytime +- `/linkedin` — See all 26 commands anytime diff --git a/plugins/linkedin-studio/skills/linkedin-studio/SKILL.md b/plugins/linkedin-studio/skills/linkedin-studio/SKILL.md index fa3644d..9797240 100644 --- a/plugins/linkedin-studio/skills/linkedin-studio/SKILL.md +++ b/plugins/linkedin-studio/skills/linkedin-studio/SKILL.md @@ -1,7 +1,7 @@ --- name: linkedin-studio description: | - Main entry point and router for the LinkedIn thought leadership plugin. Provides overview, status, and routes to 5 specialized skills. Contains shared algorithm knowledge and content quality standards. + Main entry point and router for LinkedIn Studio. Provides overview, status, and routes to 5 specialized skills. Contains shared algorithm knowledge and content quality standards. This skill should be used when the user wants a general overview, needs help choosing the right LinkedIn command, or asks about LinkedIn capabilities. Triggers on: "LinkedIn help", "LinkedIn overview", "what LinkedIn commands are available", "show LinkedIn status", "LinkedIn plugin", "LinkedIn capabilities", "how does the LinkedIn plugin work", "LinkedIn commands list". --- @@ -132,6 +132,9 @@ These rules apply to ALL content created by any skill or command: | `/linkedin:calendar` | View + manage post scheduling queue, and run the publish action (mark a scheduled post as published) | | `/linkedin:pipeline` | Full end-to-end content pipeline | | `/linkedin:newsletter` | Long-form orchestrator (newsletter editions, essays, series articles) -- single long-form entry point | +| `/linkedin:headless-review` | Cold adversarial review of a FROZEN long-form draft (argument, language, facts, reader-fit) before lock | +| `/linkedin:pivot` | Re-open a long-form edition after a late substantive change so cleared gates re-run before lock | +| `/linkedin:carousel` | Structured multi-slide carousel generator with visual layout guidance | | `/linkedin:multiplatform` | Adapt content for other platforms (short-form/cross-format) | | `/linkedin:audit` | Periodic content strategy audit | | `/linkedin:competitive` | Competitive analysis of niche | @@ -156,7 +159,12 @@ These rules apply to ALL content created by any skill or command: | `post-feedback-monitor` | Haiku | Green | Post-publish 48h monitoring, real-time interventions | | `video-scripter` | Sonnet | Violet | Video script creation with pacing + visual cues | | `fact-checker` | Opus | Brown | Factual-claim verification against primary/credible sources (longform) | -| `persona-reviewer` | Opus | Olive | Reader-persona resonance + hook-conversion gate (longform) | +| `persona-reviewer` | Opus | Olive | Reader-persona skeleton + resonance + hook-conversion gate (longform) | +| `editorial-reviewer` | Opus | Orange | Editor's craft gate — prose-craft + narrative-architecture, before the persona sweep (longform) | +| `voice-scrubber` | Opus | Red | De-AI scrub + chronicle voice-drift correction; gold standard = approved editions in the configured language (longform) | +| `content-reviewer` | Opus | Maroon | Cold/headless argument-integrity review (C1–C5) on a frozen draft (longform) | +| `language-reviewer` | Opus | Navy | Cold/headless language-quality review (L1–L5); grades against the configured language (longform) | +| `fact-reviewer` | Opus | Gold | Cold/headless re-verification (F1–F4 + pivot-risk) on the frozen draft (longform) | ---