ktg-plugin-marketplace/plugins/linkedin-studio/commands/audit.md
Kjell Tore Guttormsen b6bb61246b 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

8.7 KiB
Raw Blame History

name description allowed-tools
linkedin:audit 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".
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)

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:

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