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>

plugins/linkedin-thought-leadership/references/troubleshooting-guide.md

@@ -0,0 +1,280 @@
+# 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
+```