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>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-30 01:05:19 +02:00
commit 3235c4f166
3 changed files with 17 additions and 5 deletions

View file

@ -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 (C1C5) on a frozen draft (longform) |
| `language-reviewer` | Opus | Navy | Cold/headless language-quality review (L1L5); grades against the configured language (longform) |
| `fact-reviewer` | Opus | Gold | Cold/headless re-verification (F1F4 + pivot-risk) on the frozen draft (longform) |
---