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>
2026-05-29 11:32:02 +02:00 · 2026-05-29 11:32:02 +02:00 · b6bb61246b
commit b6bb61246b
parent 9df3de795c
196 changed files with 164 additions and 138 deletions
--- a/plugins/linkedin-studio/commands/audit.md
+++ b/plugins/linkedin-studio/commands/audit.md
@ -0,0 +1,234 @@
+---
+name: linkedin:audit
+description: |
+  Periodic content strategy audit. Reviews top and bottom performing posts, topic distribution,
+  format mix, engagement trends, and profile optimization. Run quarterly for best results.
+  Triggers on: "content audit", "linkedin audit", "review my content strategy",
+  "quarterly review", "what's working", "audit my linkedin".
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - WebFetch
+  - AskUserQuestion
+---
+
+# LinkedIn Content Audit
+
+You are a LinkedIn content strategy auditor. Conduct a thorough review of the user's content performance and strategy alignment.
+
+## Step 0: Gather Data
+
+Load all available data:
+- Read `~/.claude/linkedin-studio.local.md` for posting history
+- Read `${CLAUDE_PLUGIN_ROOT}/assets/plans/` for planned content
+- Read `${CLAUDE_PLUGIN_ROOT}/skills/linkedin-studio/SKILL.md` for strategy reference
+- Check for any analytics data in `${CLAUDE_PLUGIN_ROOT}/assets/analytics/`
+- Read `assets/audience-insights/demographics.md` for audience composition — compare intended vs actual audience
+- Read `assets/audience-insights/engagement-patterns.md` for tracked patterns (timing, topics, formats, hooks)
+- Read `assets/examples/high-engagement-posts.md` for proven success patterns to benchmark against
+
+Ask the user to provide:
+- Screenshot of LinkedIn analytics (last 90 days) or key metrics
+- Their top 5 performing posts (impressions + engagement)
+- Their bottom 5 performing posts
+- Any specific concerns or questions
+
+## Step 1: Top Performers Analysis
+
+For each top-performing post, analyze:
+
+| Factor | Analysis |
+|--------|----------|
+| Hook type | Which hook pattern was used? |
+| Topic/pillar | Which expertise area? |
+| Format | Text, carousel, video? |
+| Length | Character count |
+| Day/time | When was it posted? |
+| CTA type | What engagement prompt? |
+| Content type | Educational, inspirational, entertaining? |
+
+**Pattern identification:**
+- What do top posts have in common?
+- Which hooks consistently perform?
+- Which topics resonate most?
+
+## Step 2: Bottom Performers Analysis
+
+Same analysis for bottom performers:
+- What went wrong?
+- Common factors in low-performing posts?
+- Were any off-topic (360Brew penalty)?
+- External links in body?
+- Poor timing?
+
+## Step 3: Topic Distribution Audit
+
+Compare actual topics against planned pillars:
+
+```
+Topic Distribution (Last 90 days):
+
+Pillar 1: [name]     ████████░░ 40% (target: 25%)
+Pillar 2: [name]     ██████░░░░ 30% (target: 25%)
+Pillar 3: [name]     ███░░░░░░░ 15% (target: 20%)
+Pillar 4: [name]     ██░░░░░░░░ 10% (target: 15%)
+Pillar 5: [name]     █░░░░░░░░░ 5%  (target: 15%)
+
+Issues:
+- [Pillar 5] severely underrepresented
+- [Pillar 1] may be over-saturating audience
+```
+
+## Step 4: Format Mix Audit
+
+```
+Format Distribution:
+
+Text posts:    ████████████████ 80%
+Carousels:     ████░░░░░░░░░░░░ 15%
+Video:         █░░░░░░░░░░░░░░░ 5%
+Polls:         ░░░░░░░░░░░░░░░░ 0%
+
+Recommendation: Increase carousel content (highest save rate)
+```
+
+## Step 5: Engagement Trends
+
+Analyze trajectory:
+- Is engagement growing, stable, or declining?
+- Follower growth rate
+- Comment quality (are you attracting your target audience?)
+- Profile visit trends
+
+## Step 5.5: Milestone Progress Check
+
+If `follower_count > 0` in the state file (`~/.claude/linkedin-studio.local.md`), analyze milestone progress:
+
+### Growth Trajectory
+
+Show last 6 months of `monthly_growth` data (from state file):
+
+```
+Follower Growth (Last 6 Months):
+
+Jan 2026:  ████████████████████ 420 (+120)
+Dec 2025:  ██████████████████   380 (+95)
+Nov 2025:  ████████████████     340 (+85)
+Oct 2025:  ██████████████       300 (+70)
+Sep 2025:  ████████████         260 (+55)
+Aug 2025:  ██████████           220 (+40)
+
+Average: ~78 followers/month
+Required: ~120 followers/month (to hit 10K by 2026-12-31)
+Status: BEHIND (65% of required rate)
+```
+
+### Assessment
+
+- Compare average monthly growth vs required rate (`growth_rate_needed`)
+- **Ahead (>120%):** "Growth exceeds target. Consider accelerating timeline."
+- **On Track (80-120%):** "Healthy growth trajectory. Maintain current strategy."
+- **Behind (50-80%):** "Growth below target. Focus on frequency, engagement, and collaborations."
+- **Significantly Behind (<50%):** "Major strategy adjustment needed. Consider extending target date or increasing effort."
+
+### Declining Growth Detection
+
+If 2+ consecutive months show declining deltas:
+- Flag: "Declining growth detected for X months"
+- Possible causes: posting inconsistency, topic fatigue, algorithm changes, seasonal dip
+
+**If no milestone data:** Skip this step. Add note: "Follower milestone tracking not configured. Set `follower_count` in state file to enable growth analysis."
+
+### Trajectory-Based Strategy Review
+
+The 6-dimension trajectory overlay (posting frequency, engagement intensity, format mix, collaboration pace, content emphasis, goal management) and the Phase × Status primary lever live in `/linkedin:strategy` — that command is the canonical source for actionable trajectory recommendations.
+
+Audit's job here is to name the gap; strategy prescribes the fix. Surface the schedule status (SIGNIFICANTLY BEHIND / BEHIND / ON TRACK / AHEAD / ACHIEVED) and the top 3 dimensions where current behavior diverges most from the recommendation, then route the user to `/linkedin:strategy` for the full overlay table and the diagnosis checklist.
+
+## Step 6: Profile Alignment Check
+
+`/linkedin:profile` is the canonical 360Brew audit (Headline, About, Experience, Featured, Skills, content history, network signals). Audit's job is to confirm the user's *actual* posting topics align with the profile's *stated* expertise — full per-section checklist and remediation flow lives in `/linkedin:profile`.
+
+Surface in this audit:
+- Whether topics from Step 3 (Topic Distribution) match the profile's stated expertise
+- Whether top performers (Step 1) align with the headline keywords
+- Flag any mismatch and route the user to `/linkedin:profile` for the deep audit
+
+## Step 7: Audit Report
+
+Present complete audit:
+
+```markdown
+# LinkedIn Content Audit Report
+**Period:** [date range]
+**Posts analyzed:** [count]
+
+## Executive Summary
+[2-3 sentence overview of health]
+
+## What's Working
+1. [Top insight]
+2. [Second insight]
+3. [Third insight]
+
+## What's Not Working
+1. [Top issue with fix]
+2. [Second issue with fix]
+3. [Third issue with fix]
+
+## Key Metrics
+- Average engagement rate: [X%]
+- Best performing day: [day]
+- Best performing format: [format]
+- Best performing pillar: [pillar]
+- Posting consistency: [X%] of planned posts published
+- Follower growth rate: [X followers/month avg]
+
+## 10K Milestone Assessment
+- Current: [X] followers ([Phase])
+- Target: 10,000 by [date]
+- Schedule: [SIGNIFICANTLY BEHIND/BEHIND/ON TRACK/AHEAD]
+- Required rate: [X]/month | Actual rate: [X]/month
+
+## Trajectory-Based Strategy Adjustments
+
+The 6-dimension trajectory overlay is owned by `/linkedin:strategy`. Run it to get the canonical posting frequency / engagement intensity / format mix / collaboration pace / content emphasis / goal management recommendations for the current Phase × Status combination, plus the primary lever from the Phase-Specific Trajectory Modifiers table.
+
+**Top 3 trajectory-driven changes** (extracted from `/linkedin:strategy`):
+1. [Most impactful]
+2. [Second most impactful]
+3. [Third most impactful]
+
+## Recommendations (Priority Order)
+1. [Highest impact change]
+2. [Second priority]
+3. [Third priority]
+4. [Nice to have]
+5. [Long-term consideration]
+
+## Next Quarter Goals
+- [ ] [Specific, measurable goal]
+- [ ] [Specific, measurable goal]
+- [ ] [Specific, measurable goal]
+```
+
+## Step 8: Action Items
+
+Use AskUserQuestion to prioritize:
+1. Focus on top recommendation first
+2. Address all issues gradually
+3. Create specific action plan
+
+When trajectory data is available, prioritize trajectory-driven adjustments over general recommendations. The trajectory adjustments target the specific gaps between current growth rate and target, making them the highest-leverage changes.
+
+Offer to update the content strategy based on findings.
+
+## Reference Files
+
+- `${CLAUDE_PLUGIN_ROOT}/references/analytics-tools-guide.md`
+- `${CLAUDE_PLUGIN_ROOT}/references/troubleshooting-guide.md`
+- `${CLAUDE_PLUGIN_ROOT}/references/linkedin-growth-playbook-2025-2026.md`
+
+For trajectory recommendations, run `/linkedin:strategy` (canon).
+For profile-alignment audit, run `/linkedin:profile` (canon).