ktg-plugin-marketplace/plugins/linkedin-studio/commands/audit.md
2026-05-29 20:32:17 +02:00

234 lines
8.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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 (topic-relevance 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 topic-relevance 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).