ktg-plugin-marketplace/plugins/linkedin-thought-leadership/references/troubleshooting-guide.md
Kjell Tore Guttormsen 39f8b275a6 feat(linkedin-thought-leadership): v1.0.0 — initial open-source import
Build LinkedIn thought leadership with algorithmic understanding,
strategic consistency, and AI-assisted content creation. Updated for
the January 2026 360Brew algorithm change.

16 agents, 25 commands, 6 skills, 9 hooks, 24 reference docs.

Personal data sanitized: voice samples generalized to template,
high-engagement posts cleared, region-specific references replaced
with placeholders.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 22:09:03 +02:00

280 lines
8.5 KiB
Markdown

# Troubleshooting Guide: Why Good Content Doesn't Perform
Understanding why content fails is as important as knowing what works.
---
## Common Failure Patterns and Solutions
### Pattern: Good Content, Low Reach
**Possible causes:**
- Posted at wrong time for YOUR audience
- No pre-posting engagement (cold start)
- Topic drift confusing algorithm about your expertise
- External link penalizing reach
- Inconsistent posting breaking topical authority signal
**Solutions:**
- Test different posting times systematically
- Implement 5x5x5 pre-posting method
- Stick to 3-5 core topics for 30+ days
- Remove external links, use native formats
- Post consistently 3+ times per week
---
### Pattern: High Views, Low Engagement
**Possible causes:**
- Hook promises more than content delivers
- CTA too generic or missing
- Content doesn't invite conversation
- Too polished/corporate, not authentic
- No clear takeaway or lesson
**Solutions:**
- Ensure content fulfills hook's promise
- Use specific CTAs with genuine questions
- Add controversial element or invite disagreement
- Write more conversationally, admit uncertainties
- End with clear "so what?" implication
---
### Pattern: Good First-Hour Engagement, Then Dies
**Possible causes:**
- Didn't respond quickly to first comments
- Responses too short ("thanks!")
- No tagging of relevant people in responses
- Comment quality too low (triggering AI detection)
**Solutions:**
- Respond within 5 minutes to first comments
- Add value in every response
- Tag relevant people to extend conversation
- Encourage 15+ word responses with specific questions
---
### Pattern: Inconsistent Performance (Random Results)
**Possible causes:**
- Random topics across posts
- Varied posting times
- No clear expertise positioning
- Mixed quality (some posts rushed)
- Not tracking what actually works
**Solutions:**
- Pick 3-5 topics, stick to them for 90 days
- Post same days/times consistently
- Optimize profile for clear positioning
- Batch create to maintain quality
- Implement weekly analytics review
---
### Pattern: Plateau After Initial Growth
**Possible causes:**
- Same format repeatedly (algorithm favors variety)
- Not collaborating or engaging with others
- No optimization based on analytics
- Playing it safe (no controversial takes)
- Email list or monetization absent
**Solutions:**
- Test new formats monthly
- Strategic collaborations with complementary creators
- Monthly deep dive on what's working
- Occasional contrarian or uncomfortable truth posts
- Build Featured section with lead magnets
---
## Algorithm Penalty Checklist
If reach suddenly drops, check for:
- [ ] Did you use engagement bait language?
- [ ] Did you add external links in post or first comment?
- [ ] Have you been inconsistent (skipped week+)?
- [ ] Are topics all over the place recently?
- [ ] Did you receive generic AI-like comments?
- [ ] Did you post way more/less frequently than usual?
---
## Recovery Strategies (When Reach Declines)
Understanding how to recover from algorithmic suppression is critical for long-term success.
### Diagnosing the Problem
**Signs of algorithmic suppression:**
- Reach dropped 50%+ from baseline
- Posts getting under 500 impressions consistently
- No engagement from non-connections
- Comments from regulars but no new faces
- Profile views declining despite posting
**Common causes:**
1. **Profile-content mismatch (360Brew failure)** - Algorithm validates profile before distributing content
2. **Topic inconsistency** - Confused algorithm about your expertise
3. **Engagement pod detection** - Artificial engagement patterns flagged
4. **External link overuse** - LinkedIn penalizes directing traffic away
5. **Posting frequency gap** - More than 5 days without posting
6. **Shadow ban from policy violation** - Content flagged for misinformation, spam, or harassment
---
## 14-Day Recovery Protocol
### Days 1-3: Profile Audit
- [ ] Update headline with 3-4 topic keywords matching your content
- [ ] Rewrite About section with clear expertise areas
- [ ] Remove or update irrelevant Featured content
- [ ] Check Skills section matches post topics (critical for 360Brew)
- [ ] Request 2-3 skill endorsements from connections in your content areas
- [ ] Review Experience descriptions for topic alignment
### Days 4-7: Content Reset
- [ ] Post ONLY on your core 2-3 topics (strictest consistency)
- [ ] Use text-only format (lowest-risk, highest trust signal)
- [ ] Keep posts 1,200-1,500 characters (optimal engagement length)
- [ ] NO external links (even in comments - wait 14 days)
- [ ] NO polls or engagement-bait CTAs ("tag someone who needs this")
- [ ] Respond to every comment within 30 minutes with substantive replies
### Days 8-11: Engagement Rehabilitation
- [ ] Comment 10-15x daily on posts in your topic area
- [ ] Focus on posts from 2nd-degree connections (signals to new audiences)
- [ ] Write 15+ word substantive comments only (no "great post!")
- [ ] Like and save posts before commenting (signals genuine interest)
- [ ] Avoid commenting on engagement pod members' content
- [ ] Tag relevant people in comments to extend conversations
### Days 12-14: Gradual Expansion
- [ ] Increase post length to 1,500-1,800 characters
- [ ] Try one carousel or document (test format diversity)
- [ ] Cautiously introduce topic-adjacent content (80/20 rule)
- [ ] Monitor metrics closely for any reach changes
- [ ] Continue high engagement activity (10+ comments daily)
---
## Timeline Expectations
### Mild Suppression (25-40% reach drop)
- Initial improvement: 7-10 days
- Recovery to baseline: 14-21 days
- Full restoration with growth: 3-4 weeks
### Moderate Suppression (50-70% drop)
- Initial improvement: 2-3 weeks
- Recovery to baseline: 4-6 weeks
- Full restoration with growth: 2-3 months
### Severe Suppression/Shadow Ban
- Initial improvement: 4-6 weeks
- Recovery to baseline: 3-6 months
- Full restoration: May not be possible
- May require profile rebuild or new account
---
## When to Start Fresh
Consider creating a new account if:
- Zero reach improvement after 90 days of strict recovery protocol
- Multiple policy violations on record (visible in notifications)
- Account age <1 year with <500 followers (less to lose)
- Engagement permanently at near-zero despite quality content
- Profile can't be aligned with content (career change scenario)
**If starting fresh:**
- Don't immediately connect with old network (signals bot behavior)
- Build profile completely before first post
- Start with pure value content, no asks for 30 days
- Grow slowly and organically (10-20 connections per week max)
---
## Prevention Checklist
Maintain these practices to avoid future suppression:
- [ ] Post minimum 2x weekly (never allow >5 day gaps)
- [ ] Stay within 3-5 core topics (strict topical authority)
- [ ] Avoid engagement pods entirely (easily detected)
- [ ] Limit external links to 1x per week maximum
- [ ] Monitor reach weekly for early warning signs
- [ ] Keep profile and content aligned (360Brew validation)
- [ ] Respond to all comments within first hour
- [ ] Engage with others' content daily (10+ substantive comments)
- [ ] Use native formats primarily (text, carousels, LinkedIn video)
- [ ] Track first-hour engagement velocity as health metric
---
## Emergency Triage: First 24 Hours
If you wake up to a sudden reach collapse:
### Hour 0-2
1. Check LinkedIn notifications for policy violations
2. Review last 5 posts for potential issues
3. Document baseline metrics (screenshots)
### Hour 2-6
1. Audit profile for misalignment with content
2. Check if recent comments were flagged as spam
3. Review connection requests (mass requests can trigger flags)
### Hour 6-24
1. Start profile optimization immediately
2. DO NOT panic post or over-post
3. Begin Days 1-3 of recovery protocol
4. Increase engagement on others' content
5. Hold off on new posts until profile is optimized
### Critical: Do NOT
- Delete recent posts (signals guilt to algorithm)
- Mass delete old content (disrupts engagement history)
- Change posting frequency dramatically
- Buy followers or engagement
- Use automation tools
---
## Quick Decision Tree
```
Is your reach down?
├─ Down <25%? → Normal fluctuation, continue posting
├─ Down 25-50%? → Review last week's posts for issues
│ └─ Found issue? → Fix and continue
│ └─ No issue? → Start soft recovery (increase engagement)
├─ Down 50-75%? → Start 14-day recovery protocol
└─ Down 75%+? → Major issue
├─ Check for policy violation notifications
├─ Full profile audit
└─ Consider if starting fresh is viable
```