# LinkedIn Post Creator

## `/create-linkedin-post`

Generates a LinkedIn post from a video transcript, grounded in the knowledge-layer style guide and supplemented with real examples.

### What It Does

1. **Ingests the video transcript** -- accepts a local file path or a Tella API URL. If given a Tella URL, fetches the transcript via the Tella API.
2. **Loads the knowledge-based style guide** from the knowledge layer:
   - **Voice profile** -- tone descriptors, vocabulary patterns, phrases to use and avoid
   - **Hook patterns** -- 5 types ranked by historical engagement:
     1. Bold contrarian claim ("Most companies waste 80% of their outbound budget...")
     2. Specific number/result ("We booked 47 meetings in 3 weeks...")
     3. Direct question ("Why are you still manually writing follow-ups?")
     4. Pattern interrupt ("Stop. Before you send another cold email...")
     5. Story opener ("Last week a prospect told me something that changed how I think about...")
   - **Structure patterns** -- 5 post templates:
     1. Hook > Problem > Insight > Proof > CTA
     2. Hook > List (3-5 bullets) > Takeaway > CTA
     3. Hook > Story > Lesson > CTA
     4. Hook > Myth vs. Reality > Evidence > CTA
     5. Hook > Before/After > How > CTA
3. **Loads 3-5 supplementary LinkedIn posts** from the knowledge layer that match the topic category of the transcript (e.g., if the video is about deliverability, loads posts tagged with deliverability, email infrastructure, or outbound)
4. **Analyzes the combined style** and extracts patterns:
   - Bold, declarative hooks (no soft openings)
   - Short paragraphs (1-2 sentences max)
   - Emoji bullets for scannable lists
   - Conversational, direct tone -- talks TO the reader, not about abstract concepts
   - Specific tools mentioned by name (Clay, SmartLead, HubSpot, Apollo, etc.)
   - Real numbers and outcomes, not vague claims
5. **Generates the post** matching the analyzed style:
   - 150-300 words (LinkedIn optimal range)
   - Standalone value -- reader gets an insight even without watching the video
   - Ends with an engaging question or clear CTA to drive comments
6. **Offers 2-3 alternative versions** with different angles:
   - Different hook type
   - Different structure pattern
   - Different emphasis (e.g., tactical vs. strategic, data-focused vs. story-focused)
7. **Saves the final post** to the context directory for future reference

### Usage

```
/create-linkedin-post <transcript-path-or-tella-url>
```

Optional flags:
- `--hook <type>` -- force a specific hook pattern (1-5)
- `--structure <type>` -- force a specific structure pattern (1-5)
- `--topic <category>` -- override automatic topic detection for supplementary post selection

### Style Analysis Framework

When analyzing existing posts and the voice profile, the skill evaluates:

| Dimension | What to Look For |
|-----------|-----------------|
| **Opening** | First line strength. Does it stop the scroll? Is it specific or generic? |
| **Rhythm** | Sentence length variation. Mix of short punchy lines and slightly longer ones. |
| **Proof** | Are claims backed by specific numbers, tool names, or client references? |
| **Voice** | First person? Direct address ("you")? Informal but authoritative? |
| **Structure** | How are ideas organized? Bullets? Numbered? Narrative flow? |
| **CTA** | How does it end? Question? Challenge? Invitation to engage? |
| **Length** | Word count. Line count. Paragraph count. |

### Output Format

```
═══════════════════════════════════════════
 LINKEDIN POST — VERSION 1
 Hook: Bold contrarian claim
 Structure: Hook > Problem > Insight > Proof > CTA
═══════════════════════════════════════════

[Full post text here]

───────────────────────────────────────────
Word count: 210 | Lines: 18 | Hook type: #1
───────────────────────────────────────────


═══════════════════════════════════════════
 LINKEDIN POST — VERSION 2
 Hook: Specific number/result
 Structure: Hook > List > Takeaway > CTA
═══════════════════════════════════════════

[Full post text here]

───────────────────────────────────────────
Word count: 185 | Lines: 22 | Hook type: #2
───────────────────────────────────────────


═══════════════════════════════════════════
 LINKEDIN POST — VERSION 3
 Hook: Story opener
 Structure: Hook > Story > Lesson > CTA
═══════════════════════════════════════════

[Full post text here]

───────────────────────────────────────────
Word count: 245 | Lines: 20 | Hook type: #5
───────────────────────────────────────────

Which version do you want to go with? Or I can combine
elements from multiple versions.
```

### Notes

- The skill does NOT post to LinkedIn. It generates the text for manual posting or scheduling.
- All versions use the same core insight from the transcript -- they differ in framing and structure, not content.
- If the transcript is long (>15 minutes), the skill asks which segment or topic to focus on before generating.