refactor(linkedin)!: rename plugin linkedin-thought-leadership → linkedin-studio (v3.0.0)

BREAKING CHANGE: the marketplace slug, the agent namespace
(linkedin-studio:<agent>), and the runtime state-file path
(~/.claude/linkedin-studio.local.md) all change. Reinstall required;
existing state migrated in place (post metrics, streak, history preserved).
The /linkedin:* commands are unchanged — the command namespace is set
per-command in frontmatter and was always independent of the plugin slug.
Functionality is byte-identical to v2.4.0; this release is pure identity.

- dir + manifests: plugins/linkedin-studio + plugin.json + root marketplace.json
- agent namespace updated in commands/newsletter.md (only functional invoker)
- state path updated in 4 hook scripts + topic-rotation prompt + state template
- catch-all skill dir renamed skills/linkedin-studio (5 functional skills unchanged)
- docs + version bump to 3.0.0 across README badge, CHANGELOG, root README/CLAUDE.md
- historical records (CHANGELOG past entries, docs/ build artifacts,
  config-audit v5.0.0 snapshots) intentionally retain the old slug

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-29 11:32:02 +02:00
commit 52fa87a255
59 changed files with 148 additions and 122 deletions

View file

@ -0,0 +1,173 @@
---
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.
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".
---
## Personalization
**To customize this skill for your voice and goals:**
1. Copy `config/user-profile.template.md` to `config/user-profile.local.md`
2. Fill in your profile, voice preferences, and goals
3. The skill will use your settings when generating content
If no personalization file exists, the skill works with generic best practices.
---
## Skill Architecture
This plugin uses **6 focused skills**. This main skill contains shared knowledge (algorithm, quality, personalization). Domain-specific guidance lives in the specialized skills:
| Skill | Domain | Key Commands |
|-------|--------|--------------|
| **linkedin-content-creation** | Post creation, templates, batch, pipeline, video, long-form | `/linkedin:post`, `/linkedin:quick`, `/linkedin:batch`, `/linkedin:pipeline`, `/linkedin:multiplatform`, `/linkedin:video`, `/linkedin:newsletter` |
| **linkedin-analytics** | Analysis, reporting, import, troubleshooting | `/linkedin:analyze`, `/linkedin:audit`, `/linkedin:import`, `/linkedin:report` |
| **linkedin-strategy** | Growth, authority, competitive, monetization | `/linkedin:strategy`, `/linkedin:competitive`, `/linkedin:monetize` |
| **linkedin-networking** | Engagement, collaborations, speaking | `/linkedin:outreach` |
| **linkedin-voice** | Voice training, profile, differentiation | `/linkedin:profile` |
### Routing Guide
| User Intent | Route To |
|-------------|----------|
| "Just installed" / "Walk me through" | `/linkedin:onboarding` |
| "Set up plugin" | `/linkedin:setup` |
| "Personalize" | `/linkedin:setup` |
| "Improve personalization" | `/linkedin:setup` |
| "Write a LinkedIn post" | linkedin-content-creation |
| "Quick post about..." | linkedin-content-creation |
| "Create a week of content" | linkedin-content-creation |
| "Turn this into a carousel" | linkedin-content-creation |
| "Create a video script" | linkedin-content-creation |
| "LinkedIn video" | linkedin-content-creation |
| "Video for LinkedIn" | linkedin-content-creation |
| "Why isn't my content performing?" | linkedin-analytics |
| "Generate weekly report" | linkedin-analytics |
| "Import my LinkedIn data" | linkedin-analytics |
| "Audit my content strategy" | linkedin-analytics |
| "How do I grow on LinkedIn?" | linkedin-strategy |
| "Build my authority" | linkedin-strategy |
| "What are competitors doing?" | linkedin-strategy |
| "How to monetize LinkedIn" | linkedin-strategy |
| "Find speaking opportunities" | linkedin-networking |
| "Collaborate with someone" | linkedin-networking |
| "Engagement strategy" | linkedin-networking |
| "Optimize my profile" | linkedin-voice |
| "Does this sound like me?" | linkedin-voice |
| "Is this original enough?" | linkedin-voice |
---
### Algorithm Context (360Brew - January 2026)
LinkedIn's 360Brew algorithm now validates your profile across 5 criteria (About, Experience, Content History, Network, Engagement Patterns) BEFORE distributing content. Strong profile alignment = wider distribution. See the `linkedin-voice` skill for detailed profile optimization guidance and the full 360Brew framework.
---
## Shared Knowledge: Content Quality Rules
These rules apply to ALL content created by any skill or command:
1. **Hook:** 110-140 characters (mobile cutoff threshold)
2. **Post length:** 1,200-1,800 chars (standard), 150-500 chars (quick)
3. **No external links** in post body (40-50% reach suppression)
4. **No corporate buzzwords:** leverage, synergy, paradigm shift, thought leader, disruptive, value proposition, ecosystem, holistic approach
5. **Topic alignment:** Must align with user's 5 core expertise areas (360Brew signal)
6. **Voice:** Always read `assets/voice-samples/` before generating content
7. **Quality scorecard:** See `assets/checklists/quality-scorecard.md`
---
## Shared Knowledge: Quick Start Guide
### First 24 Hours
**Hour 1 -- Foundation (15 min):**
- Rewrite headline: WHO you help + RESULT you deliver
- Review first 3 lines of About section (use linkedin-voice skill)
**Hour 2-3 -- Content Planning (30 min):**
- Pick 3-5 core topics
- Stick to these for 90 days minimum
**Hour 4-6 -- Create First Post (45 min):**
- Use linkedin-content-creation skill
- Structure: Hook -> Context -> Insight -> Implication -> CTA
- Check: 1,200-1,800 characters
**Hour 7-24 -- Strategic Engagement (30 min):**
- 5x5x5 method (see linkedin-networking skill)
- Respond within 5 minutes to first comments
**Week 1 Commitments:**
- Post 3x this week
- 15 minutes daily strategic commenting
- Respond to all comments within 2 hours
- Track each post in LinkedIn Analytics
---
## All Commands
| Command | Purpose |
|---------|---------|
| `/linkedin` | Router -- shows status line + command menu |
| `/linkedin:onboarding` | Multi-step onboarding wizard (profile → setup → first-post) |
| `/linkedin:first-post` | First-post accelerator (zero to published in 10 min) |
| `/linkedin:setup` | Guided setup to populate asset templates with real data |
| `/linkedin:react` | URL-to-post pipeline -- react to articles, news, research |
| `/linkedin:post` | Full post creation (10-15 min workflow) |
| `/linkedin:quick` | 5-minute quick post (3-line formula) |
| `/linkedin:profile` | 360Brew profile optimization |
| `/linkedin:analyze` | Content/performance analysis |
| `/linkedin:ab-test` | Design and manage A/B content tests |
| `/linkedin:strategy` | Growth strategy planning |
| `/linkedin:import` | Import CSV export to structured JSON |
| `/linkedin:report` | Generate weekly performance report |
| `/linkedin:batch` | Create a full week of content |
| `/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:multiplatform` | Adapt content for other platforms (short-form/cross-format) |
| `/linkedin:audit` | Periodic content strategy audit |
| `/linkedin:competitive` | Competitive analysis of niche |
| `/linkedin:monetize` | Monetization strategy and funnels |
| `/linkedin:outreach` | Outreach orchestrator — collaborations + speaking opportunities |
| `/linkedin:video` | Video script generator (30s/60s/90s/2min) |
## All Agents
| Agent | Model | Color | Responsibility |
|-------|-------|-------|----------------|
| `content-optimizer` | Sonnet | Blue | Optimize existing posts |
| `strategy-advisor` | Sonnet | Green | Growth recommendations |
| `analytics-interpreter` | Sonnet | Yellow | Audience pattern analysis + weekly/monthly performance reports (interpret/report modes) |
| `engagement-coach` | Sonnet | Magenta | 5x5x5 + first-hour tactics + CEA commenting + target selection |
| `content-planner` | Sonnet | Cyan | Content audit + weekly/monthly plans |
| `network-builder` | Sonnet | Cyan | Strategic networking + outreach |
| `content-repurposer` | Sonnet | Magenta | Format conversion + evergreen refresh |
| `trend-spotter` | Sonnet | Cyan | Trending topics + opportunity scores |
| `voice-trainer` | Sonnet | Magenta | Voice profile building + drift detection |
| `differentiation-checker` | Sonnet | Blue | Originality scoring + commodity detection |
| `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) |
---
### Reference Files
Each specialized skill includes its own relevant references. Key shared references:
- `references/algorithm-signals-reference.md` — Algorithm mechanics and signals
- `references/glossary.md` — Plugin terminology (38 terms)
- `references/troubleshooting-guide.md` — When reach drops or content underperforms
- `references/first-comment-strategy.md` — First comment timing and tactics
- `references/linkedin-visual-style.md` — Visual content standards and guidelines
For domain-specific references, see each skill's reference section.