/linkedin-self-improvement-loop

name: linkedin-self-improvement-loop
description: A build-measure-learn loop for your LinkedIn. Ingests your Creator analytics export, keeps a persistent belief model of what drives your reach and engagement, reconciles last cycle's beliefs against the new data, proposes ONE experiment to run next, and hands draft briefs to a drafting skill. Run it on a cadence and it compounds. Use when the user says "/linkedin-self-improvement-loop", "improve my LinkedIn", "what should I post next", "did my last experiment work", or hands over a fresh LinkedIn analytics export. Advisory by design: it proposes and drafts, a human always posts. No API keys.

LinkedIn self-improvement loop

Most "content analytics" is a noun: a report you read once and forget. This is a verb. It runs the **build-measure-learn loop** on your LinkedIn and keeps **state**, so every cycle compounds on the last instead of starting from zero.

  1. MEASURE  -> 2. RECONCILE -> 3. UPDATE BELIEFS
  (ingest export)  (did last        (confidence rises if a
        ^           cycle's bet       pattern held, halves if
        |           hold up?)         it broke)
        |                                  |
  6. WAIT  <- 5. DRAFT BRIEFS <- 4. PROPOSE ONE EXPERIMENT
  (re-run next  (hand to a          (biggest effect on the
   export)       drafting skill)     least-settled belief)

It is **advisory**: it proposes experiments and emits draft briefs, but a human writes and posts every post. It never touches LinkedIn directly.

State it keeps (in `--state`, default `./state`)

| File | What | |---|---| | `beliefs.json` / `beliefs.md` | The model: ranked traits (topic/hook/day/length) with a confidence that updates each cycle. `.md` is git-friendly and readable. | | `ledger.jsonl` | One line per cycle: what was reconciled, discovered, proposed. The audit trail. | | `snapshots/<date>.json` | Parsed metrics from each export, so trends compute across exports (beats the top-50 survivorship trap over time). |

A belief is just: *"posts with this trait beat your average on the chosen metric."* It starts at low confidence, climbs ~0.34 of the way to 1.0 each cycle it survives, and halves when a new export contradicts it. Survive enough cycles and it's a law; break and it's archived.

What the user downloads (same two files every cycle)

1. **Creator analytics (required)** - `AggregateAnalytics_<name>_<dates>.xlsx`. LinkedIn -> profile -> **Analytics** -> **Export**. Impressions, engagements, top-50 posts, followers, demographics. (LinkedIn caps it at the top ~50 posts / 365 days.) 2. **Data archive (optional, recommended)** - the `Complete_LinkedInDataExport` zip (**Settings -> Data Privacy -> Get a copy of your data -> larger archive**, email, ~24h). Its `Shares_*.csv` carries full post text so the loop can tag topics and hooks.

Step 1: Locate the export

ls ~/Desktop ~/Downloads 2>/dev/null | grep -iE "AggregateAnalytics|LinkedInDataExport"

Step 2: Run a cycle

cd skills/linkedin-self-improvement-loop
python loop.py \
  --analytics "/path/to/AggregateAnalytics_Name_dates.xlsx" \
  --archive   "/path/to/Complete_LinkedInDataExport_folder" \
  --state ./state \
  --metric engagements        # or impressions | er

`--metric` picks what the loop optimizes. `engagements` is the sane default for a personal brand (reach is mostly downstream of engagement + the algorithm). Use `impressions` only if pure reach is the goal, and read the ER caveat below before you do.

The loop prints its report to stdout and updates `./state`. Read the report straight back to the user, in this order: **RECONCILE** (did last bet hold), **PROPOSE** (the one experiment), **DRAFT BRIEFS**.

Step 3: One-off deep snapshot (optional)

For a full one-time report (all the tables, top/bottom posts, correlations) without the loop machinery, run the MEASURE stage directly:

python analyze.py --analytics "...xlsx" --archive "...folder" --out ./out

This writes a styled Excel workbook + tagged CSV. Good for handing a human a static read; the loop is for the recurring improvement cycle.

Step 4: Draft toward the experiment

Take the DRAFT BRIEFS and expand them into real posts. If a drafting skill exists (e.g. `social-content`), hand it each brief's `topic` / `hook` / `post_on` and let it write in the user's voice. Tag each post mentally with the brief's `tests` field so next cycle's reconciliation means something. **Never auto-post** - output drafts, the human ships them.

Step 5: Schedule the next cycle

This is what makes it a loop, not a one-off. After enough posts to measure (~2 weeks), re-run with the next export. Offer to wire it:

/schedule a linkedin-self-improvement-loop run every 2 weeks

Each run tells the user whether the last bet paid off and picks the next one.

Read the numbers honestly (say this every cycle)

• **Engagement rate is inversely tied to reach.** A 12k-impression post shows a lower ER%

than a 900-impression post with equal raw engagement. The loop's default metric (`engagements`) sidesteps this; if you switch to `er`, know it rewards small posts.

• **Survivorship bias, fading over time.** Any single export is the top ~50 posts only. The

loop's `snapshots/` defeat this *across* cycles, but in cycle 1 a "loss" belief just means "weakest of your winners," not "this bombs."

• **Small n.** Day-of-week and rare hooks can ride on 3-5 posts. The loop ignores anything

under n=3 and shows n in every row. Treat a 1.6x effect on n=3 as a hint, not a law, until cycles confirm it.

• **Engagements is one blended number** (no reaction/comment/share split), and native

image/carousel posts usually have no `MediaUrl`, so the loop can't judge media vs text. Don't fake a conclusion there.

Tuning

Topic and hook detection are two regex dicts at the top of `analyze.py` (`TOPICS`, `HOOKS`), tuned for a B2B / GTM / CRM brand. Edit for a different niche. Loop b