open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

fix(linkedin-studio): honest saves/dwell wording, no false tracking claim

Browse source 
Wave 2 / Step 7 of the remediation plan (research/02 D2/D4).

The tool parses the LinkedIn analytics CSV export, which has no saves/dwell — and
there is no self-serve API to pull them. Stop implying it tracks them:
- report.md: replace "Saves (10x weight) and expert comments (7-9x) are the
  highest-impact signals" with honest wording — saves rank highest in the
  engagement ORDER (cite references/algorithm-signals-reference.md, not a restated
  coefficient), but are visible only in native LinkedIn post analytics (count-only,
  ~Sept 2025+) with no self-serve API, so this tool does not auto-track them; dwell
  is internal to LinkedIn for organic posts.
- types.ts: document why PostMetrics intentionally omits saves/dwell (no ingest
  source) so a future contributor does not "add the missing fields".
- strategy.md: reconcile two saves references (signature-content criterion +
  authority scorecard) to say the count is read from native LinkedIn analytics, not
  captured by this tool.

No new metric field, no manual-entry feature (operator Q3).

Verify: report.md has no "Saves (10x"/"highest-impact signals" and does say "no
self-serve API"; tsc --noEmit clean; analytics suite 106/106; structural lint
0 failed (report.md cites the reference, so stat-consistency stays green).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-30 00:28:23 +02:00
commit 6ed3e2f5a6
3 changed files with 8 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

2
plugins/linkedin-studio/commands/report.md
View file

@ -236,7 +236,7 @@ Compare current week's `aggregateMetrics` against baseline means and standard de
🔴 **Critical: Engagement rate declining**
Your engagement rate has dropped from 4.2% to 2.8% over the last 3 weeks.
→ **Action:** Review recent post hooks. Consider more provocative angles or questions.
→ **Reference:** Hook length should be <140 chars. Saves (10x weight) and expert comments (7-9x) are the highest-impact signals.
→ **Reference:** Hook length should be <140 chars. In the engagement order (see `references/algorithm-signals-reference.md`), saves rank above shares, then quality comments, then reactions. Saves are visible in your native LinkedIn post analytics (count-only, ~Sept 2025 onward) but there is no self-serve API to pull them — so this tool does not auto-track saves; read them in LinkedIn directly. Dwell time is internal to LinkedIn for organic posts (not exposed anywhere this tool can read).
🟢 **Positive: New impression record**
Your post on [topic] achieved 12,500 impressions — a personal best!

4
plugins/linkedin-studio/commands/strategy.md
View file

@ -296,7 +296,7 @@ For the canonical profile-alignment audit (headline/About/Experience/Featured/Sk
Ask the user to identify their top-performing posts (or read analytics from `${CLAUDE_PLUGIN_ROOT}/assets/analytics/`).
**Signature content criteria:**
- High saves (people bookmarking = authority signal)
- High saves — bookmarking is a strong authority signal; read the count from your native LinkedIn post analytics (this tool does not capture saves)
- Quality comments from target audience
- Profile visits generated
- Shares/reposts by others
@ -404,7 +404,7 @@ Suggest tracking these monthly:
Authority Scorecard: [Month]
Content Impact:
- Posts with 100+ saves: [count]
- Posts with 100+ saves: [count] _(read from native LinkedIn analytics — not auto-tracked by this tool)_
- Expert comments received: [count]
- Profile visits from content: [count]