fix(linkedin-studio): propagate reconciled algorithm numbers, cite-not-restate

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-29 20:32:17 +02:00
commit 4700248cc4
32 changed files with 133 additions and 113 deletions

View file

@ -179,11 +179,11 @@ Based on how much reach dropped:
Based on diagnosis, provide specific action plan.
### If Profile-Content Mismatch (360Brew Failure)
### If Profile-Content Mismatch (topic-relevance Failure)
**Days 1-3: Profile Audit**
`/linkedin:profile` is the canonical 360Brew audit — headline scoring, About section structure, Experience impact statements, Featured curation, Skills alignment, content history check, and network signals. Run it for the per-section checklist and the remediation flow.
`/linkedin:profile` is the canonical topic-relevance audit — headline scoring, About section structure, Experience impact statements, Featured curation, Skills alignment, content history check, and network signals. Run it for the per-section checklist and the remediation flow.
Quick triage if a full audit can wait:
- Headline contains 3-4 topic keywords matching content pillars
@ -224,7 +224,7 @@ Set realistic expectations:
| Suppression Level | Initial Improvement | Baseline Recovery | Full Restoration |
|-------------------|---------------------|-------------------|------------------|
| Mild (25-40% drop) | 7-10 days | 14-21 days | 3-4 weeks |
| Moderate (link / off-topic) | 7-10 days | 14-21 days | 3-4 weeks |
| Moderate (50-70% drop) | 2-3 weeks | 4-6 weeks | 2-3 months |
| Severe (75%+ drop) | 4-6 weeks | 3-6 months | May not be possible |

View file

@ -58,7 +58,7 @@ For each top-performing post, analyze:
Same analysis for bottom performers:
- What went wrong?
- Common factors in low-performing posts?
- Were any off-topic (360Brew penalty)?
- Were any off-topic (topic-relevance penalty)?
- External links in body?
- Poor timing?
@ -148,7 +148,7 @@ Audit's job here is to name the gap; strategy prescribes the fix. Surface the sc
## 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`.
`/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

View file

@ -2,7 +2,7 @@
name: linkedin:carousel
description: |
Create a LinkedIn carousel post with structured slide-by-slide content and visual layout guidance.
Carousels have the highest engagement rate (6.6%) on LinkedIn. Guides template selection,
Carousels/documents are the top-performing organic format on LinkedIn. Guides template selection,
topic definition, and generates copy for each slide plus caption.
Optionally generates slide images via mcp-image (Nano Banana Pro).
Triggers on: "carousel", "slide deck", "pdf post", "swipe post", "multi-slide",
@ -33,7 +33,7 @@ Read `assets/templates/carousel-templates.md` for the 5 templates.
Present the options:
```
LinkedIn carousels get 6.6% average engagement — highest of all formats.
LinkedIn carousels/documents are the top-performing organic format (~7%; see `references/algorithm-signals-reference.md`).
Choose a template:

View file

@ -87,7 +87,7 @@ Present these options to the user:
| Command | Purpose |
|---------|---------|
| `/linkedin:strategy` | Growth strategy + authority building (phase-specific guidance, trajectory adjustments, signature content for Phase 2+) |
| `/linkedin:profile` | 360Brew profile optimization checklist |
| `/linkedin:profile` | profile/topic-relevance optimization checklist |
| `/linkedin:analyze` | Analyze content performance or troubleshoot issues |
| `/linkedin:ab-test` | Design and manage A/B tests for content optimization |
| `/linkedin:audit` | Quarterly content strategy audit |
@ -133,7 +133,7 @@ Use AskUserQuestion to ask:
8. **View calendar** — See scheduled posts and manage queue
9. **Plan content** — Weekly/monthly content planning
10. **Growth strategy & authority** — Plan growth, build signature content, compound authority
11. **Optimize profile**360Brew profile audit
11. **Optimize profile**topic-relevance profile audit
12. **Audit content** — Review what's working and what's not
13. **Competitive analysis** — Learn from other thought leaders
14. **Monetize** — Revenue strategies for thought leadership
@ -168,7 +168,7 @@ If the user's intent is clear from context:
- Mentions "calendar" or "schedule" or "queue" or "upcoming posts" or "what's scheduled" → Route to `/linkedin:calendar`
- Mentions "publish" or "mark as published" or "posted today" or "just published" or "post is live" → Route to `/linkedin:calendar` (publish action)
- Mentions "plan" → Suggest `content-planner` agent
- Mentions "profile" or "360Brew" → Route to `/linkedin:profile`
- Mentions "profile" or "topic-relevance" → Route to `/linkedin:profile`
- Mentions "not working" or "low reach" → Route to `/linkedin:analyze`
- Mentions "strategy" or "growth plan" or "authority" or "build authority" or "signature content" or "greatest hits" or "my best content" → Route to `/linkedin:strategy`
- Mentions "carousel" or "slides" or "slide deck" or "pdf post" or "swipe" or "document post" → Route to `/linkedin:carousel`

View file

@ -341,7 +341,7 @@ DM Conversion Framework:
- Not ready: "No rush — follow along and reach out when timing is right"
Response time matters:
- Same day: 40-50% conversion to next step
- Same day: roughly half convert to the next step
- Next day: 20-30% conversion
- 3+ days: <10% conversion
```
@ -492,7 +492,7 @@ ACTIONS FOR NEXT MONTH:
❌ Selling too early (before 1K followers with engagement)
→ Build trust with 8+ weeks of consistent value first
❌ External links in posts (kills reach by 25-40%)
❌ External links in posts (correlate with lower reach — see `references/algorithm-signals-reference.md`)
→ Use first comment for links, or bio link
❌ Generic CTAs ("check out my service")

View file

@ -38,14 +38,14 @@ Read `~/.claude/linkedin-studio.local.md` for current state.
Post templates 5 [✓ Done / ○ Empty]
```
- Use AskUserQuestion: "Would you like to re-run a specific phase?"
1. Re-optimize profile (360Brew) → jump to Phase 1
1. Re-optimize profile (topic-relevance) → jump to Phase 1
2. Improve personalization → jump to Phase 2
3. Create another post → suggest `/linkedin:post` or `/linkedin:quick`
4. Exit
If not already onboarded, continue to Phase 1.
## Phase 1: Profile Optimization (360Brew)
## Phase 1: Profile Optimization (topic-relevance)
```
╔═══════════════════════════════════════╗
@ -54,16 +54,16 @@ If not already onboarded, continue to Phase 1.
```
Explain briefly:
- LinkedIn's 360Brew algorithm (January 2026) validates your profile BEFORE distributing your content
- LinkedIn's topic-relevance ranking (2026) validates your profile BEFORE distributing your content
- A weak profile means even great posts get suppressed
- This takes 5 minutes and has outsized impact on everything else
Use AskUserQuestion:
1. **Guide me through profile optimization** — I want the full 360Brew checklist
1. **Guide me through profile optimization** — I want the full profile/topic-relevance checklist
2. **Already optimized** — I've already done this, skip ahead
3. **Do it later** — Skip for now, I'll run `/linkedin:profile` later
**If option 1:** Walk through the core 360Brew checklist (condensed from `/linkedin:profile`):
**If option 1:** Walk through the core profile/topic-relevance checklist (condensed from `/linkedin:profile`):
- [ ] Professional headshot (face visible, good lighting)
- [ ] Headline with expertise + value prop (not just job title)
- [ ] About section with story arc + CTA (not a resume)

View file

@ -1,32 +1,32 @@
---
name: linkedin:profile
description: |
360Brew profile optimization checklist for LinkedIn's January 2026 algorithm update.
profile/topic-relevance optimization checklist for LinkedIn's 2026 algorithm update.
LinkedIn now validates your profile BEFORE distributing content. This command audits
and optimizes your profile for maximum reach. Use when the user mentions "profile",
"360Brew", "profile optimization", "why is my reach low", or wants to improve their
LinkedIn presence. Triggers on: "optimize profile", "360Brew check", "profile audit",
"topic-relevance", "profile optimization", "why is my reach low", or wants to improve their
LinkedIn presence. Triggers on: "optimize profile", "profile/topic-relevance check", "profile audit",
"linkedin profile help", "fix my profile".
allowed-tools:
- Read
- AskUserQuestion
---
# LinkedIn Profile Optimization (360Brew Audit)
# LinkedIn Profile Optimization (Profile/Topic Audit)
You are a LinkedIn profile optimization specialist. Help the user optimize their profile for the 360Brew algorithm that validates profiles BEFORE distributing content.
You are a LinkedIn profile optimization specialist. Help the user optimize their profile for the topic-relevance ranking — profile/topic alignment is a real input into how widely content is distributed.
## Critical Context: 360Brew (January 2026)
## Critical Context: Profile/Topic Relevance
Read `references/algorithm-signals-reference.md` for algorithm mechanics.
**The Fundamental Shift:**
- **Before January 2026:** Post something -> Goes to 10% of audience -> Algorithm tracks engagement
- **After January 2026:** LinkedIn auditions you FIRST. Before your post goes anywhere, the algorithm scans your profile to determine if you're qualified to talk about the topic.
- **In the older feed model:** Post something -> Goes to 10% of audience -> Algorithm tracks engagement
- **In the 2026 relevance model:** profile/topic relevance is weighed alongside engagement — content matched to your demonstrated expertise is distributed more widely (including beyond your network), so an off-topic post from a misaligned profile tends to underperform.
**If profile doesn't match post topic = -40-60% reach before anyone sees it.**
**Profile/topic alignment is a real ranking input — content matched to your demonstrated expertise is distributed more widely (see `references/algorithm-signals-reference.md`).**
## The 360Brew Scoring System
## The Profile/Topic Relevance Factors
LinkedIn's 150B parameter foundation model evaluates five criteria:
@ -62,7 +62,7 @@ Guide the user through each section using AskUserQuestion for interactive feedba
### Section 2: About Section (2,600 characters max)
**Critical:** This is the first signal telling 360Brew what you're qualified to discuss.
**Critical:** This is the first signal telling topic-relevance what you're qualified to discuss.
**Structure:**
@ -124,7 +124,7 @@ Guide the user through each section using AskUserQuestion for interactive feedba
### Section 5: Skills Section
**Critical for 360Brew validation.**
**Critical for profile/topic-relevance validation.**
**Ask the user:** What skills are listed on your profile?
@ -136,7 +136,7 @@ Guide the user through each section using AskUserQuestion for interactive feedba
### Section 6: Network Quality
**360Brew checks if you're connected to professionals in your expertise area.**
**profile/topic-relevance checks if you're connected to professionals in your expertise area.**
**Ask the user:** Who are you primarily connected with? (peers, clients, random connections?)
@ -189,7 +189,7 @@ Based on the audit, provide a prioritized action list:
- Connect with domain experts
- Maintain consistency between profile and content
## The 360Brew Validation Test
## The Profile/Topic Alignment Test
Before posting, the user should ask themselves:
@ -199,6 +199,6 @@ If the answer is no, fix the profile FIRST before posting.
## Reference Files
- `references/algorithm-signals-reference.md` - 360Brew mechanics and signals
- `references/algorithm-signals-reference.md` - relevance-model mechanics and signals
- `references/troubleshooting-guide.md` - Recovery if reach is already down
- `skills/linkedin-studio/SKILL.md` - User's expertise areas and topics

View file

@ -109,7 +109,7 @@ Structure the post:
**CTA:** Engagement question related to the topic.
### Critical Rules:
- **NEVER put the URL in the post body**LinkedIn suppresses reach 40-50% for external links
- **NEVER put the URL in the post body**external links correlate with lower reach (see `references/algorithm-signals-reference.md`); use the first comment and lead with value
- Mention the URL should go in the first comment
- The post should stand alone without needing to read the source
- Focus on YOUR perspective, not a summary of the article

View file

@ -84,7 +84,7 @@ Based on follower count, place user in the right phase:
- Learning what works
**Focus areas:**
- Profile optimization (360Brew critical)
- Profile optimization (topic-relevance critical)
- Finding your voice
- Establishing consistency
- Building initial engagement habits
@ -171,7 +171,7 @@ Based on their phase, provide detailed guidance.
|----------|-----------|---------|
| Core expertise posts | 3-5x/week | Algorithm learning |
| Strategic commenting | Daily 20 min | Network expansion |
| Profile optimization | Monthly review | 360Brew validation |
| Profile optimization | Monthly review | profile/topic-relevance validation |
| Content experimentation | Ongoing | Finding what works |
**Milestone Markers to Track:**
@ -289,7 +289,7 @@ Once the user is in Phase 2 (3,000+) the growth lever shifts from finding-what-w
**Skip this section in Phase 01.** The signal there is consistency + voice discovery, not compounding. Reference it once they cross 3K.
For the canonical profile-alignment audit (headline/About/Experience/Featured/Skills against post topics), run `/linkedin:profile` — the 360Brew checker is the single source. This section covers the content + network side of authority.
For the canonical profile-alignment audit (headline/About/Experience/Featured/Skills against post topics), run `/linkedin:profile` — the profile/topic-relevance checker is the single source. This section covers the content + network side of authority.
### Identify Signature Content
@ -357,7 +357,7 @@ Use AskUserQuestion to pick which derivatives to create.
### Authority Signals Audit (Content + Network)
**Profile signals:** delegated to `/linkedin:profile` (canonical 360Brew audit).
**Profile signals:** delegated to `/linkedin:profile` (canonical topic-relevance audit).
**Content authority:**
- [ ] Consistent posting in expertise areas
@ -516,7 +516,7 @@ Remind them of the long-term view:
- `references/growth-roadmaps.md` - Detailed phase roadmaps
- `references/linkedin-growth-playbook-2025-2026.md` - Comprehensive tactics
- `references/trajectory-strategy-adjustments.md` - Trajectory-based strategy adjustments
- `references/algorithm-signals-reference.md` - 360Brew signals (authority audit)
- `references/algorithm-signals-reference.md` - topic-relevance signals (authority audit)
- `references/collaborations-guide.md` - Partnership strategies
- `references/opportunity-generation.md` - Business development
- `references/newsletter-strategy-guide.md` - For 5K+ followers