# timscheuerai/linkedin-funnel architecture

> Architecture diagram of the GitHub repository timscheuerai/linkedin-funnel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/timscheuerai/linkedin-funnel
- Repository: https://github.com/timscheuerai/linkedin-funnel

## Overview

LinkedIn Funnel is a reusable, agent-oriented system for turning personal expertise into content, identifying relevant engagers, and starting sales conversations. Its main workflow is to build brand context, create and distribute content, collect engagement, qualify people against an ICP, then continue useful conversations. The repository primarily supplies skills, guides, templates, and workspace scaffolding rather than a single running application. The graph preserves documented optional Notion and OXYGEN workflows and standalone media tools; links to unsampled subsystems reflect README descriptions, not inspected implementations.

Main entry points: [`templates/qualification-prompt.md`](https://github.com/timscheuerai/linkedin-funnel/blob/main/templates/qualification-prompt.md) (ICP qualification), [`skills/linkedin-copywriter/SKILL.md`](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/linkedin-copywriter/SKILL.md) (Content skills), [`skills/lead-magnet-delivery/references/delivery-recipe.example.mjs`](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/lead-magnet-delivery/references/delivery-recipe.example.mjs) (Comment-to-DM recipe), [`context/index.md`](https://github.com/timscheuerai/linkedin-funnel/blob/main/context/index.md) (Brand second brain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_context["Brand context"]
  node_brand_context["Brand second brain<br/>[index.md]"]
  node_voice["Voice calibration<br/>[SKILL.md]"]
end

subgraph group_content["Content creation"]
  node_content_skills["Content skills<br/>[SKILL.md]"]
  node_weekly_plan["Weekly planning<br/>[SKILL.md]"]
  node_waterfall["Content waterfall<br/>[SKILL.md]"]
  node_notion["Content board<br/>[notion.md]"]
  node_lead_magnet["Lead magnet<br/>[SKILL.md]"]
end

subgraph group_qualification["Audience qualification"]
  node_profile_watcher["Profile watcher<br/>[profile-watcher.md]"]
  node_engagement_table[("Engagement table<br/>[profile-watcher.md]")]
  node_qualification["ICP qualification"]
  node_rubric["Fit rubric<br/>[icp-rubric.md]"]
end

subgraph group_conversation["Conversation and media"]
  node_dm_framework["DM framework<br/>[dm-conversion.md]"]
  node_delivery_recipe["Comment-to-DM recipe"]
  node_video_cut["Talking-head editor<br/>[render_cut.py]"]
  node_flowchart["Flowchart authoring<br/>[flowchart.py]"]
  node_primitives["Diagram primitives<br/>[primitives.py]"]
end

node_creator(("User / agent"))
node_oxygen{{"OXYGEN platform"}}
node_linkedin{{"LinkedIn"}}

node_creator -->|"builds context"| node_brand_context
node_brand_context -->|"calibrates voice"| node_voice
node_creator -->|"creates content"| node_content_skills
node_content_skills -->|"plans weekly"| node_weekly_plan
node_creator -->|"runs workflow"| node_waterfall
node_creator -.->|"sets up board"| node_notion
node_content_skills -->|"creates resource"| node_lead_magnet
node_creator -->|"sets up collection"| node_profile_watcher
node_profile_watcher -->|"configures watcher"| node_oxygen
node_oxygen -->|"collects profiles"| node_engagement_table
node_creator -->|"assesses fit"| node_qualification
node_engagement_table -->|"provides evidence"| node_qualification
node_rubric -->|"guides scoring"| node_qualification
node_qualification -->|"informs follow-up"| node_dm_framework
node_dm_framework -->|"guides conversation"| node_creator
node_lead_magnet -.->|"delivers resource"| node_delivery_recipe
node_delivery_recipe -->|"reads and sends"| node_linkedin
node_delivery_recipe -->|"records delivery"| node_oxygen
node_creator -.->|"renders video"| node_video_cut
node_creator -.->|"draws funnel"| node_flowchart
node_flowchart -->|"loads primitives"| node_primitives

click node_brand_context "https://github.com/timscheuerai/linkedin-funnel/blob/main/context/index.md"
click node_voice "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/voice-calibration/SKILL.md"
click node_content_skills "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/linkedin-copywriter/SKILL.md"
click node_weekly_plan "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/week-posts/SKILL.md"
click node_waterfall "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/content-waterfall/SKILL.md"
click node_notion "https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/notion.md"
click node_lead_magnet "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/lead-magnet-creator/SKILL.md"
click node_profile_watcher "https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/profile-watcher.md"
click node_engagement_table "https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/profile-watcher.md"
click node_qualification "https://github.com/timscheuerai/linkedin-funnel/blob/main/templates/qualification-prompt.md"
click node_rubric "https://github.com/timscheuerai/linkedin-funnel/blob/main/templates/icp-rubric.md"
click node_dm_framework "https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/dm-conversion.md"
click node_delivery_recipe "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/lead-magnet-delivery/references/delivery-recipe.example.mjs"
click node_video_cut "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/talking-head-video-cut/scripts/render_cut.py"
click node_flowchart "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/flowchart/scripts/flowchart.py"
click node_primitives "https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/flowchart/scripts/primitives.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_brand_context,node_voice,node_creator toneBlue
class node_content_skills,node_weekly_plan,node_waterfall,node_notion,node_lead_magnet toneAmber
class node_profile_watcher,node_engagement_table,node_qualification,node_rubric toneMint
class node_dm_framework,node_delivery_recipe,node_video_cut,node_flowchart,node_primitives toneRose
class node_oxygen,node_linkedin toneIndigo
```

## Components

### Brand context

- [Brand second brain](https://github.com/timscheuerai/linkedin-funnel/blob/main/context/index.md): `context/index.md`
- [Voice calibration](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/voice-calibration/SKILL.md): `skills/voice-calibration/SKILL.md`

### Content creation

- [Content skills](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/linkedin-copywriter/SKILL.md): `skills/linkedin-copywriter/SKILL.md`
- [Weekly planning](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/week-posts/SKILL.md): `skills/week-posts/SKILL.md`
- [Content waterfall](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/content-waterfall/SKILL.md): `skills/content-waterfall/SKILL.md`
- [Content board](https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/notion.md): `guides/notion.md`
- [Lead magnet](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/lead-magnet-creator/SKILL.md): `skills/lead-magnet-creator/SKILL.md`

### Audience qualification

- [Profile watcher](https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/profile-watcher.md): `guides/profile-watcher.md`
- [Engagement table](https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/profile-watcher.md): `guides/profile-watcher.md`
- [ICP qualification](https://github.com/timscheuerai/linkedin-funnel/blob/main/templates/qualification-prompt.md): `templates/qualification-prompt.md`
- [Fit rubric](https://github.com/timscheuerai/linkedin-funnel/blob/main/templates/icp-rubric.md): `templates/icp-rubric.md`

### Conversation and media

- [DM framework](https://github.com/timscheuerai/linkedin-funnel/blob/main/guides/dm-conversion.md): `guides/dm-conversion.md`
- [Comment-to-DM recipe](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/lead-magnet-delivery/references/delivery-recipe.example.mjs): `skills/lead-magnet-delivery/references/delivery-recipe.example.mjs`
- [Talking-head editor](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/talking-head-video-cut/scripts/render_cut.py): `skills/talking-head-video-cut/scripts/render_cut.py`
- [Flowchart authoring](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/flowchart/scripts/flowchart.py): `skills/flowchart/scripts/flowchart.py`
- [Diagram primitives](https://github.com/timscheuerai/linkedin-funnel/blob/main/skills/flowchart/scripts/primitives.py): `skills/flowchart/scripts/primitives.py`

### Other components

- **User / agent**
- **OXYGEN platform**
- **LinkedIn**

## Connections

- User / agent → Brand second brain: builds context (evidence: `README.md`)
- Brand second brain → Voice calibration: calibrates voice (evidence: `README.md`)
- User / agent → Content skills: creates content (evidence: `README.md`)
- Content skills → Weekly planning: plans weekly (evidence: `README.md`)
- User / agent → Content waterfall: runs workflow (evidence: `README.md`)
- User / agent → Content board: sets up board (evidence: `README.md`)
- Content skills → Lead magnet: creates resource (evidence: `README.md`)
- User / agent → Profile watcher: sets up collection (evidence: `README.md`)
- Profile watcher → OXYGEN platform: configures watcher (evidence: `README.md`)
- OXYGEN platform → Engagement table: collects profiles (evidence: `README.md`)
- User / agent → ICP qualification: assesses fit (evidence: `README.md`)
- Engagement table → ICP qualification: provides evidence (evidence: `README.md`)
- Fit rubric → ICP qualification: guides scoring (evidence: `README.md`)
- ICP qualification → DM framework: informs follow-up (evidence: `README.md`)
- DM framework → User / agent: guides conversation (evidence: `README.md`)
- Lead magnet → Comment-to-DM recipe: delivers resource (evidence: `README.md`)
- Comment-to-DM recipe → LinkedIn: reads and sends (evidence: `skills/lead-magnet-delivery/references/delivery-recipe.example.mjs`)
- Comment-to-DM recipe → OXYGEN platform: records delivery (evidence: `skills/lead-magnet-delivery/references/delivery-recipe.example.mjs`)
- User / agent → Talking-head editor: renders video (evidence: `README.md`)
- User / agent → Flowchart authoring: draws funnel (evidence: `README.md`)
- Flowchart authoring → Diagram primitives: loads primitives (evidence: `skills/flowchart/scripts/flowchart.py`)
