docs(linkedin-studio): reconcile discoverability surfaces + skill naming

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 <noreply@anthropic.com>

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.
 

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 `<!-- VOICE_PLACEHOLDER -->`.
 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

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) |
 
 ---