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

8.5 KiB

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