neuron-inspector 0.3.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,552 @@
1
+ # Content Repurposing — Initial Learnings
2
+
3
+ This file tracks what we know (and learn over time) about effective content repurposing across platforms.
4
+
5
+ Last updated: 2026-09-05
6
+
7
+ ---
8
+
9
+ ## Starting Assumptions
10
+
11
+ These are the best practices we're starting with, before real data comes in.
12
+
13
+ ### Best Source → Target Pairs
14
+
15
+ #### High Confidence (Likely to work well)
16
+
17
+ 1. **X thread → LinkedIn post**
18
+ - Why: LinkedIn rewards depth, X forces conciseness. Expanding compressed insight into full narrative fits LinkedIn's format perfectly.
19
+ - Success indicators: Threads with clear frameworks, personal lessons, or technical breakdowns.
20
+ - Avoid: Hot takes, memes, purely reactive content.
21
+
22
+ 2. **Blog post → X thread**
23
+ - Why: Long-form content contains multiple insights. Threading creates natural structure.
24
+ - Success indicators: How-to content, listicles, frameworks, step-by-step guides.
25
+ - Avoid: Highly technical posts with lots of code (doesn't thread well), narrative essays (lose flow).
26
+
27
+ 3. **Instagram reel → TikTok video**
28
+ - Why: Same format, similar audiences, content can cross directly.
29
+ - Success indicators: Trending audio, relatable content, strong hook in first 2 seconds.
30
+ - Avoid: Branded content (feels like ad repurpose), overly polished (TikTok wants authentic).
31
+
32
+ 4. **X viral post → Instagram graphic**
33
+ - Why: High-engagement text can become shareable visual content.
34
+ - Success indicators: Quotes, insights, surprising stats, contrarian takes.
35
+ - Avoid: Time-sensitive news, inside jokes, X-specific references.
36
+
37
+ #### Medium Confidence (Might work)
38
+
39
+ 1. **LinkedIn post → X thread**
40
+ - Why: Can compress long-form into punchy insights.
41
+ - Risk: LinkedIn tone doesn't always translate. Needs significant re-writing.
42
+ - Success indicators: Data-heavy posts, clear frameworks, step-by-step advice.
43
+
44
+ 2. **YouTube video → Blog post**
45
+ - Why: Transcribe and edit into written form for different audience.
46
+ - Risk: Spoken word doesn't always read well. Requires heavy editing.
47
+ - Success indicators: Educational content, tutorials, interviews.
48
+
49
+ 3. **TikTok trend → Instagram reel**
50
+ - Why: Cross-pollinate trending content.
51
+ - Risk: Instagram audiences often 1-2 weeks behind TikTok trends. Timing matters.
52
+ - Success indicators: Evergreen trends (not fleeting memes).
53
+
54
+ #### Low Confidence (Risky)
55
+
56
+ 1. **LinkedIn article → TikTok video**
57
+ - Why: Tone mismatch. Professional thought leadership rarely translates to casual short video.
58
+ - When it works: Personal storytelling angle exists, can visualize with b-roll.
59
+
60
+ 2. **TikTok video → LinkedIn post**
61
+ - Why: Format and tone mismatch.
62
+ - When it works: Behind-the-scenes of professional work, day-in-the-life for career content.
63
+
64
+ 3. **X hot take → Facebook post**
65
+ - Why: Facebook engagement has declined for text posts, different algorithm.
66
+ - When it works: Community-specific content, local news, event-based.
67
+
68
+ ### What to Preserve vs. What to Change
69
+
70
+ #### Always Preserve
71
+
72
+ 1. **Core insight** — the reason the original content was valuable
73
+ 2. **Data points** — numbers, stats, specific examples
74
+ 3. **Author credibility** — expertise signals, experience markers
75
+ 4. **Call to action** — if the original had one, adapt it to target platform
76
+ 5. **Brand voice** — if repurposing your own content, maintain consistency
77
+
78
+ #### Always Change
79
+
80
+ 1. **Platform-specific language**
81
+ - X: No "I'm excited to share" (LinkedIn-speak)
82
+ - LinkedIn: No "ratio" or "W" (X-speak)
83
+ - TikTok: No corporate jargon
84
+ - Instagram: No walls of text
85
+
86
+ 2. **Format conventions**
87
+ - Length (280 chars vs 1300 vs caption vs thread)
88
+ - Media aspect ratio (1:1 vs 4:5 vs 9:16)
89
+ - Structure (single post vs thread vs carousel)
90
+
91
+ 3. **Tone formality**
92
+ - X: Fast, sharp, opinionated
93
+ - LinkedIn: Thoughtful, professional, personal
94
+ - TikTok: Casual, self-aware, playful
95
+ - Instagram: Aspirational, lifestyle-oriented
96
+
97
+ 4. **Hashtag strategy**
98
+ - X: Minimal (1-2 max)
99
+ - LinkedIn: Selective (3-5 relevant)
100
+ - Instagram: Generous (8-15 mix of popular and niche)
101
+ - TikTok: Trending-focused (3-5)
102
+
103
+ 5. **Visual style**
104
+ - LinkedIn: Clean, professional graphics
105
+ - Instagram: High-quality, aesthetic, branded
106
+ - TikTok: Raw, authentic, trend-participating
107
+ - X: Flexible, but lean toward screenshots and data viz
108
+
109
+ #### Situational (Depends on content)
110
+
111
+ 1. **Attribution**
112
+ - Preserve if educational/informative content
113
+ - Remove if adapting a style/format rather than specific insight
114
+
115
+ 2. **Examples**
116
+ - Keep if platform-agnostic
117
+ - Change if platform-specific (e.g., X UI example won't work on LinkedIn)
118
+
119
+ 3. **Humor**
120
+ - Keep if it survives tone shift
121
+ - Remove if it's platform-specific (LinkedIn doesn't do X's irony well)
122
+
123
+ 4. **Personal details**
124
+ - Keep if it adds authenticity
125
+ - Remove if it doesn't fit target platform norms
126
+
127
+ ---
128
+
129
+ ## Adaptation Principles
130
+
131
+ ### 1. Match Platform Intent
132
+
133
+ Each platform has a dominant user intent:
134
+
135
+ - **X:** What's happening now? What do smart people think about this?
136
+ - **LinkedIn:** What should I know professionally? What can I learn from others' experiences?
137
+ - **Instagram:** What's beautiful/aspirational/relatable? What lifestyle do I want?
138
+ - **TikTok:** What's entertaining/trendy/authentic right now?
139
+ - **Facebook:** What's happening in my community? What do my friends care about?
140
+
141
+ Your adaptation should align with that intent.
142
+
143
+ **Example:**
144
+ - Original (X): "AI pricing is broken. Companies charge per token but users think in outcomes."
145
+ - LinkedIn adaptation: "I've analyzed 50+ AI product pricing models. Here's why most will fail in the next 18 months..." [expand into thought leadership]
146
+ - Instagram adaptation: Card graphic with quote "AI pricing is broken" + visual breakdown of token vs outcome pricing
147
+ - TikTok adaptation: "Story time: I tried to explain API pricing to my mom and realized the entire AI industry has a UX problem" [casual, storytelling angle]
148
+
149
+ ### 2. Respect Platform Length Culture
150
+
151
+ Don't fight the platform's natural length preference:
152
+
153
+ - **X:** If it doesn't fit in 280 chars, thread it. If it doesn't thread well, it's not X content.
154
+ - **LinkedIn:** 1300 chars is the sweet spot. Shorter feels incomplete. Longer gets truncated.
155
+ - **Instagram:** Caption should support the visual, not replace it. 150-300 words.
156
+ - **TikTok:** Caption is secondary to video. 1-2 sentences max.
157
+
158
+ **Bad repurposing:** Taking a 1200-word LinkedIn post and cramming it into a single X post. It feels rushed and incomplete.
159
+
160
+ **Good repurposing:** Taking the same post and extracting 5-7 key insights, each becoming a tweet in a thread.
161
+
162
+ ### 3. Adapt Engagement Mechanisms
163
+
164
+ Each platform has different engagement triggers:
165
+
166
+ - **X:** Retweets, quote tweets, replies. Users engage by amplifying or debating.
167
+ - **LinkedIn:** Comments, shares. Users engage by adding their perspective.
168
+ - **Instagram:** Saves, shares to story, DMs. Users engage by bookmarking and forwarding.
169
+ - **TikTok:** Duets, stitches, comments. Users engage by remixing.
170
+
171
+ Your CTA should match the platform's engagement style:
172
+
173
+ - **X:** "Thoughts?" "RT if you agree" "Reply with your take"
174
+ - **LinkedIn:** "What's been your experience with this?" "Curious to hear other perspectives"
175
+ - **Instagram:** "Save this for later" "Share with someone who needs this" "Tag a friend"
176
+ - **TikTok:** "Duet this with your version" "Stitch and tell me I'm wrong"
177
+
178
+ ### 4. Timing Matters
179
+
180
+ **When to repurpose:**
181
+
182
+ - **Immediate (same day):** If the insight is evergreen and platforms don't overlap much (e.g., X → LinkedIn)
183
+ - **1-2 days later:** If platforms have some audience overlap, let the original content peak first
184
+ - **1 week later:** If repurposing viral/trending content, wait for it to age out on source platform
185
+ - **Never:** If content is time-sensitive news that will be stale on target platform
186
+
187
+ **Time of day:** Match target platform's peak hours, not source platform's.
188
+
189
+ - X: 8-10am, 5-7pm (commute times)
190
+ - LinkedIn: 7-9am, 12-1pm (work hours)
191
+ - Instagram: 11am-1pm, 7-9pm (lunch and evening)
192
+ - TikTok: 6-9pm, 9-11pm (evening leisure)
193
+
194
+ ### 5. Don't Lazy Repurpose
195
+
196
+ Bad repurposing is obvious:
197
+
198
+ - Screenshot of X thread posted to LinkedIn with caption "Thoughts?" (zero effort)
199
+ - Copy-paste with different hashtags (no adaptation)
200
+ - Instagram post to Facebook with no changes (cross-post, not repurpose)
201
+
202
+ Good repurposing is invisible:
203
+
204
+ - Audience on each platform thinks the content was created specifically for them
205
+ - Tone, length, format all feel native
206
+ - Media is optimized for the platform (not just resized)
207
+
208
+ If someone follows you on both platforms, they should see two different expressions of the same idea, not the same content twice.
209
+
210
+ ---
211
+
212
+ ## Content Type Repurpose-ability
213
+
214
+ ### High Repurpose-ability
215
+
216
+ 1. **Frameworks and models**
217
+ - Why: Platform-agnostic, visual-friendly, evergreen
218
+ - Best targets: All platforms (adapt format)
219
+ - Example: "3 types of startup risk" works as X thread, LinkedIn post, IG carousel, TikTok video
220
+
221
+ 2. **Personal lessons/experiences**
222
+ - Why: Storytelling adapts well across platforms
223
+ - Best targets: X → LinkedIn, Blog → X thread, TikTok → Instagram
224
+ - Example: "I failed my first startup" can be expanded for LinkedIn, threaded for X, told casually for TikTok
225
+
226
+ 3. **How-to and tutorials**
227
+ - Why: Educational content has demand everywhere
228
+ - Best targets: Blog → X thread, YouTube → Blog, X thread → LinkedIn
229
+ - Example: "How to negotiate your salary" works everywhere with tone adjustment
230
+
231
+ 4. **Data and research**
232
+ - Why: Surprising stats are shareable across platforms
233
+ - Best targets: Blog → X + LinkedIn + IG graphic, Research report → Twitter thread
234
+ - Example: "Users spend 80% of time on 20% of features" — works everywhere
235
+
236
+ ### Medium Repurpose-ability
237
+
238
+ 1. **Opinion pieces and takes**
239
+ - Why: Tone is hard to translate, some platforms don't reward pure opinion
240
+ - Best targets: X → LinkedIn (if you add context), Blog → X (if you sharpen)
241
+ - Risk: Hot takes don't age well, controversial content might not fit all platforms
242
+
243
+ 2. **News and current events**
244
+ - Why: Time-sensitive, some platforms lag behind
245
+ - Best targets: X → Instagram (if you visualize), X → LinkedIn (if you analyze)
246
+ - Risk: Stale content performs poorly
247
+
248
+ 3. **Behind-the-scenes content**
249
+ - Why: Works for some industries/niches, not all
250
+ - Best targets: Instagram → TikTok, TikTok → Instagram
251
+ - Risk: Professional audiences (LinkedIn) might not care about BTS of your daily routine
252
+
253
+ ### Low Repurpose-ability
254
+
255
+ 1. **Memes and platform-specific humor**
256
+ - Why: Context doesn't translate, inside jokes fail
257
+ - When it works: Only if the meme format is universal
258
+ - Example: X meme format rarely works on LinkedIn
259
+
260
+ 2. **Highly technical deep-dives**
261
+ - Why: Can't compress without losing value, visual adaptation is hard
262
+ - When it works: If you extract one insight and expand on it
263
+ - Example: 5000-word technical post won't thread well, but one section might
264
+
265
+ 3. **Real-time commentary**
266
+ - Why: Loses relevance quickly, platforms have different news cycles
267
+ - When it works: If you add analysis/takeaways that outlast the news
268
+ - Example: Live-tweeting an event won't repurpose well, but your summary might
269
+
270
+ ---
271
+
272
+ ## Platform-Specific Considerations
273
+
274
+ ### X (Twitter)
275
+
276
+ **What works here:**
277
+ - Fast takes, sharp insights, threads
278
+ - News, hot takes, industry commentary
279
+ - Data visualizations, screenshots, charts
280
+ - Humor, wit, concise storytelling
281
+
282
+ **What doesn't:**
283
+ - Long-form narrative (use threads or link out)
284
+ - Polished marketing speak (feels inauthentic)
285
+ - Corporate announcements (unless you're a brand account)
286
+
287
+ **Repurposing from X:**
288
+ - Expand threads into LinkedIn posts or blog posts
289
+ - Visualize popular tweets into Instagram graphics
290
+ - Turn viral threads into newsletter content
291
+
292
+ **Repurposing to X:**
293
+ - Compress long-form into threads
294
+ - Extract the most surprising insight from data
295
+ - Sharpen the hook, remove fluff
296
+
297
+ ### LinkedIn
298
+
299
+ **What works here:**
300
+ - Professional insights, career lessons, industry analysis
301
+ - Personal stories with professional takeaways
302
+ - Thought leadership, frameworks, how-to content
303
+ - Company/team wins (product launches, hiring)
304
+
305
+ **What doesn't:**
306
+ - Memes (unless very relevant and high-quality)
307
+ - Purely personal content (vacation photos)
308
+ - Hard sales pitches (engagement killer)
309
+
310
+ **Repurposing from LinkedIn:**
311
+ - Compress into X threads (extract key insights)
312
+ - Turn into blog posts (expand with more detail)
313
+ - Create IG graphics (visualize frameworks)
314
+
315
+ **Repurposing to LinkedIn:**
316
+ - Expand X threads with personal context
317
+ - Add professional framing to blog content
318
+ - Humanize data with your experience
319
+
320
+ ### Instagram
321
+
322
+ **What works here:**
323
+ - Visual-first content (photos, reels, carousels)
324
+ - Lifestyle, behind-the-scenes, personal brand
325
+ - Educational carousels (swipe-through how-tos)
326
+ - Aspirational content, before/after, transformations
327
+
328
+ **What doesn't:**
329
+ - Text-heavy posts (caption can support, not replace visual)
330
+ - Corporate content without human element
331
+ - Low-quality visuals (Instagram is aesthetic-driven)
332
+
333
+ **Repurposing from Instagram:**
334
+ - Turn reels into TikTok videos
335
+ - Pull quotes from captions for X posts
336
+ - Expand carousel topics into blog posts
337
+
338
+ **Repurposing to Instagram:**
339
+ - Visualize X threads into carousel posts
340
+ - Screenshot blog quotes with branded design
341
+ - Turn data into infographic posts
342
+
343
+ ### TikTok
344
+
345
+ **What works here:**
346
+ - Authentic, casual, relatable video
347
+ - Trend participation (sounds, formats, challenges)
348
+ - Storytelling, day-in-the-life, tutorials
349
+ - Entertainment-first, education-second
350
+
351
+ **What doesn't:**
352
+ - Overly polished, corporate content
353
+ - Long setups (hook in first 2 seconds or lose them)
354
+ - Text-heavy content (this is video platform)
355
+
356
+ **Repurposing from TikTok:**
357
+ - Cross-post to Instagram Reels
358
+ - Transcribe and expand into blog posts
359
+ - Pull quotes for X posts
360
+
361
+ **Repurposing to TikTok:**
362
+ - Turn blog how-tos into quick tutorial videos
363
+ - Adapt Instagram reels (but change caption/sound)
364
+ - Film yourself reading/reacting to your own written content
365
+
366
+ ### Facebook
367
+
368
+ **What works here:**
369
+ - Community content, local news, events
370
+ - Long-form storytelling (Facebook still supports this)
371
+ - Video content (Facebook pushes video hard)
372
+ - Group-specific content (niche communities)
373
+
374
+ **What doesn't:**
375
+ - Generic text posts (engagement is down)
376
+ - Content without community angle
377
+ - Pure reshares from other platforms
378
+
379
+ **Repurposing from Facebook:**
380
+ - Turn long posts into blog posts or LinkedIn articles
381
+ - Extract insights for X threads
382
+ - Repurpose community questions into educational content
383
+
384
+ **Repurposing to Facebook:**
385
+ - Share blog posts with community context
386
+ - Adapt LinkedIn thought pieces for niche groups
387
+ - Cross-post video content from other platforms
388
+
389
+ ---
390
+
391
+ ## Quality Signals (When to Repurpose)
392
+
393
+ Not all content deserves repurposing. Here's what to look for:
394
+
395
+ ### High Signal (Repurpose This)
396
+
397
+ 1. **Engagement above baseline**
398
+ - Source content is performing 2x+ your average
399
+ - Comments indicate the insight resonated
400
+ - Shares suggest it has reach potential
401
+
402
+ 2. **Evergreen insight**
403
+ - Not time-sensitive news
404
+ - Not dependent on current events
405
+ - Will be relevant in 6 months
406
+
407
+ 3. **Clear core value**
408
+ - You can explain in one sentence why this content matters
409
+ - It teaches something, shares an insight, or tells a story
410
+ - It's not just filler or engagement bait
411
+
412
+ 4. **Cross-platform potential**
413
+ - The insight isn't platform-specific
414
+ - You can see how to adapt tone/format for other platforms
415
+ - The content type translates (not too format-dependent)
416
+
417
+ ### Medium Signal (Maybe Repurpose)
418
+
419
+ 1. **Moderate engagement**
420
+ - Performing at your average, not above
421
+ - Some comments, but not overwhelming response
422
+ - Could perform better with better packaging
423
+
424
+ 2. **Niche-specific**
425
+ - Relevant to a specific audience segment
426
+ - Might work on platforms where that niche is active
427
+ - Requires more context for broader audience
428
+
429
+ 3. **Time-sensitive but not stale**
430
+ - Related to current trend, but insight outlasts the trend
431
+ - News-adjacent, but the takeaway is evergreen
432
+ - Can be reframed to remove time-sensitivity
433
+
434
+ ### Low Signal (Don't Repurpose)
435
+
436
+ 1. **Low engagement**
437
+ - Below your baseline
438
+ - Few reactions, no comments
439
+ - Signal that the insight didn't land
440
+
441
+ 2. **Highly platform-specific**
442
+ - Inside jokes, memes, platform dynamics
443
+ - Won't make sense outside the source platform
444
+ - Format is too tied to the platform
445
+
446
+ 3. **Filler content**
447
+ - Posted just to maintain presence
448
+ - No strong insight or value
449
+ - Repurposing won't improve it
450
+
451
+ 4. **Already saturated**
452
+ - Everyone is talking about this
453
+ - Your take isn't unique enough
454
+ - Better to create new content than join the pile-on
455
+
456
+ ---
457
+
458
+ ## Success Metrics
459
+
460
+ How to evaluate if repurposing is working:
461
+
462
+ ### Immediate Metrics (First 48 hours)
463
+
464
+ - **Engagement rate:** Target engagement > 50% of source engagement
465
+ - **Reach:** Target reach > 30% of source reach (accounting for different follower counts)
466
+ - **Quality of engagement:** Comments that show understanding, not just reactions
467
+ - **Saves/shares:** Indicates the content has utility beyond single view
468
+
469
+ ### Medium-term Metrics (1-2 weeks)
470
+
471
+ - **Follow growth:** Did repurposed content bring new followers on target platform?
472
+ - **Profile visits:** Are people discovering you through repurposed content?
473
+ - **Link clicks:** If you linked to original source, are people exploring?
474
+ - **Conversation quality:** Did it start meaningful discussions?
475
+
476
+ ### Long-term Metrics (Monthly)
477
+
478
+ - **Content efficiency:** Repurposing 1 piece into 3 platforms = 3x content output
479
+ - **Platform balance:** Are you growing on multiple platforms, not just one?
480
+ - **Compounding value:** Are repurposed pieces finding new audiences months later?
481
+ - **Pattern recognition:** Which repurposing strategies consistently work?
482
+
483
+ ### Red Flags (Stop Doing This)
484
+
485
+ - Repurposed content consistently underperforms original
486
+ - Followers on target platform complain about seeing duplicate content
487
+ - Engagement rate drops over time (audience fatigue)
488
+ - You're spending more time repurposing than creating
489
+
490
+ ---
491
+
492
+ ## Learnings Log
493
+
494
+ As we run this recipe, we'll track actual results here.
495
+
496
+ ### Session 1 — [Date to be filled]
497
+ - Source platform:
498
+ - Target platform:
499
+ - Content repurposed:
500
+ - Results:
501
+ - Learnings:
502
+
503
+ ### Session 2 — [Date to be filled]
504
+ - Source platform:
505
+ - Target platform:
506
+ - Content repurposed:
507
+ - Results:
508
+ - Learnings:
509
+
510
+ [This section will grow with real data]
511
+
512
+ ---
513
+
514
+ ## Anti-Patterns to Avoid
515
+
516
+ 1. **Lazy cross-posting:** Just hitting "share to Facebook/X/LinkedIn" without adaptation
517
+ 2. **Tone-deaf adaptation:** Professional content made "casual" with forced slang
518
+ 3. **Over-repurposing:** Same content on 5 platforms = audience fatigue
519
+ 4. **Ignoring platform trends:** Posting static images to TikTok, long threads to LinkedIn
520
+ 5. **Forgetting attribution:** Repurposing others' content without credit
521
+ 6. **Chasing every trend:** Not all trending content should be repurposed
522
+ 7. **Sacrificing quality for quantity:** 10 mediocre repurposes < 2 great ones
523
+
524
+ ---
525
+
526
+ ## Evolution Triggers
527
+
528
+ Update this file when:
529
+
530
+ 1. **After 10 repurposing sessions:** Review what worked, update "Best Pairs" section
531
+ 2. **When engagement patterns emerge:** Add new success patterns to "Quality Signals"
532
+ 3. **When platform changes happen:** Update platform-specific considerations
533
+ 4. **When adaptation approaches prove successful:** Document in "Adaptation Principles"
534
+ 5. **When failures teach lessons:** Add to "Anti-Patterns"
535
+
536
+ ---
537
+
538
+ ## Questions to Answer Over Time
539
+
540
+ 1. Is there an optimal time gap between original post and repurpose?
541
+ 2. Does repurposing your own high-performing content work better than repurposing others'?
542
+ 3. Which content types have the highest ROI for repurposing effort?
543
+ 4. Do audiences notice/care about repurposed content, or is it invisible to them?
544
+ 5. What's the engagement drop-off curve? (Original = 100%, repurpose 1 = X%, repurpose 2 = Y%)
545
+ 6. Is there a "best path" for content flow? (e.g., always start on X, expand to LinkedIn, visualize for IG)
546
+ 7. How does repurposing affect overall content strategy? (More reach vs risk of repetition)
547
+
548
+ These answers will emerge from actual data.
549
+
550
+ ---
551
+
552
+ **Next review:** After 10 sessions or 30 days, whichever comes first.