Creator Intelligence Engine
What This Is
A full extraction pipeline that takes any Instagram handle (or client) and builds a complete
intelligence database: every video deconstructed, every hook cataloged, every framework extracted,
every editing style documented, performance tracked over time. Queryable on demand.
Pipeline Overview
@handle
│
▼
Phase 1: SCRAPE (Apify)
│ All posts, engagement, metadata
▼
Phase 2: DOWNLOAD (yt-dlp)
│ Top 20-30 videos by performance
▼
Phase 3: DECONSTRUCT (AI Cookbook + Hume + Twelve Labs)
│ Frames, transcription, emotion, scene analysis
▼
Phase 4: EXTRACT (Content Market Fit + framework extraction)
│ Hooks, topics, scripts, frameworks, editing DNA
▼
Phase 5: DATABASE (Notion)
│ Creator profile + per-video entries + aggregated stats
▼
Phase 6: QUERY
"What's working for @X right now?"
Phase 1: Scrape (Apify)
Output
- CSV/JSON of all posts with metadata
- Sorted by performance (views descending)
- Tagged by content type
Phase 2: Download Top Videos
# Download S-Tier and A-Tier reels (top 20-30)
# For each video:
yt-dlp --write-info-json -o "creator_handle/%(id)s.%(ext)s" [VIDEO_URL]
Phase 3: Deconstruct Each Video
For each downloaded video, run the full analysis stack:
3a. Frame Extraction
# Standard: 1 frame every 3 seconds
ffmpeg -i video.mp4 -vf "fps=1/3" -q:v 2 frames/frame_%03d.jpg
# Detailed (for editing style analysis): 1 frame every 0.5 seconds
ffmpeg -i video.mp4 -vf "fps=2" -q:v 2 frames/frame_%03d.jpg
3b. Audio + Transcription
ffmpeg -y -i video.mp4 -vn -acodec pcm_s16le -ar 16000 audio.wav
# Transcribe with word timestamps
mlx_whisper.transcribe('audio.wav', path_or_hf_repo='mlx-community/whisper-large-v3-turbo', word_timestamps=True)
3d. Emotion Detection (Hume AI)
- Run on audio: detect emotion peaks
- Map emotion arc across the video duration
- Identify: hook emotion, peak emotion, closing emotion
3e. Video Understanding (Twelve Labs)
- Scene segmentation
- Action recognition
- Object detection
- Overall video classification
Phase 4: Extract Intelligence (Per Video)
For each video, produce a structured analysis:
Video Deconstruction Card
## Video: [Title/First Line]
**URL:** [Instagram URL]
**Posted:** [Date]
**Duration:** [Seconds]
**Performance:** [Views] views | [Likes] likes | [Comments] comments | [ER]% engagement
**Tier:** [S/A/B/C]
### Hook (First 3 Seconds)
- **Text:** "[Exact opening words]"
- **Hook Type:** [Question / Bold Claim / Pattern Interrupt / Story / Stat / Controversy]
- **Visual:** [What's on screen in first 3 seconds]
- **Emotion:** [From Hume - curiosity, surprise, authority, etc.]
### Topic
- **Category:** [AI Tools / Business / Lifestyle / Tutorial / etc.]
- **Subtopic:** [Specific angle]
- **Evergreen?** [E] Evergreen / [D] Dated / [T] Trending
### Script Structure
- **Framework:** [Hook → Problem → Solution → CTA / Hook → Story → Lesson / etc.]
- **Full Script:** [Complete transcription]
- **Word Count:** [X words in Y seconds = Z WPM]
- **Key Phrases:** [Memorable lines]
### CTA
- **Type:** [Comment keyword / Follow / Link in bio / Share / Save / None]
- **Exact CTA:** "[Their exact words]"
- **ManyChat trigger:** [If applicable]
### Emotion Arc (from Hume)
- **Opening:** [emotion]
- **Peak:** [emotion at timestamp]
- **Close:** [emotion]
### Content Market Fit Alignment
- **Which Corner:** [YOU / AUDIENCE / OFFER — which corner does this video serve?]
- **Worldview expressed:** [What belief/value does this video reveal?]
### Recreate Prompt
- **Script template:** [Generalized version anyone could use]
- **Interview questions to ask:** [3-5 questions to get a client to produce similar content]
- **Image generation prompt:** [Nano Banana Pro prompt for thumbnail/visual]
- **Video generation prompt:** [Higgsfield/Kling prompt for animation]
Phase 5: Database (Notion)
Phase 6: Query Interface
Client Intelligence (Extension for Viral Editz Clients)
Same pipeline PLUS these additional fields:
Dave Compliance Notes
Database Purity
- Creator Intelligence ≠ Council. Council = their brain (frameworks, expertise, when to consult them). Creator Intelligence = their content machine (hooks, performance, editing style, format data). A creator like @ownease can exist in BOTH — Council for his course teachings, Creator Intelligence for his content patterns.
- Client Intelligence ≠ Client Profiles. Client Profiles = psychology, speech patterns, proven hooks (existing DB). Client Intelligence = performance tracking, video deconstruction, competitor matching, editing style analysis. They relate to each other (Client Intelligence entries link to Client Profiles).
Layer Placement
- Creator Intelligence DB → Machine Layer (HOW to execute: content patterns are tools)
- Video Deconstruction DB → Machine Layer (HOW to execute: deconstructed videos are reference)
- Hook Swipe File → Deferred (embedded in Video Deconstruction for now)
Safety
- All operations are ADDITIVE. No deletions. No restructuring.
- Re-scrapes ADD new data with dated Change Log entries, never overwrite.
Dave Gate Status
- Creator Intelligence: PASSED — solves real bottleneck of manual video pattern analysis
- Video Deconstruction: PASSED — enables systematic recreation and comparison
- Hook Swipe File: DEFERRED — not yet a proven bottleneck, hooks live in Video Deconstruction
Full Specification
Complete details, decision trees, protocols, and implementation specs: references/full-details.md
Change Log
[2026-03-13]: Context Diet — split 430 lines into routing card (190 lines) + references/full-details.md (268 lines). Zero content deleted. By skill-diet.py.
2026-02-06: Created. Source: Luis Carrillo brain dump session. Designed as the master extraction pipeline for both creators the user follows and Viral Editz clients. Integrates with Content Market Fit, AI Cookbook, Video Intelligence, and all content creation skills. Notion databases designed (Creator Intelligence, Video Deconstruction, Hook Swipe File).
1---2name: creator-intelligence3description: Scrape, deconstruct, and database any Instagram creator or Viral Editz client's entire content strategy. Input = Instagram handle or client name. Output = full Notion database with deconstructed videos, hooks, scripts, frameworks, editing styles, performance data, Content Market Fit profile, and queryable intelligence. This is the BUSINESS tool for Viral Editz clients and creators — NOT for personal/dating intel (use ig-profile-scraper for that). Triggers: "deconstruct this creator", "add to creator database", "competitor analysis", "creator intelligence", "client database", "viral database", new client onboarding, "compare to", "find similar creators", "what's working for", "content strategy for @handle", "analyze their content", "creator breakdown", "scrape their IG", "scrape @handle", any Instagram handle or URL. DEFAULT RULE: This is the DEFAULT skill for ALL Instagram scraping. If the user drops an IG handle or URL, this fires FIRST. Only route to ig-profile-scraper if the user explicitly asks for person4---56# Creator Intelligence Engine78## What This Is910A full extraction pipeline that takes any Instagram handle (or client) and builds a complete11intelligence database: every video deconstructed, every hook cataloged, every framework extracted,12every editing style documented, performance tracked over time. Queryable on demand.1314## Pipeline Overview1516```17@handle18 │19 ▼20Phase 1: SCRAPE (Apify)21 │ All posts, engagement, metadata22 ▼23Phase 2: DOWNLOAD (yt-dlp)24 │ Top 20-30 videos by performance25 ▼26Phase 3: DECONSTRUCT (AI Cookbook + Hume + Twelve Labs)27 │ Frames, transcription, emotion, scene analysis28 ▼29Phase 4: EXTRACT (Content Market Fit + framework extraction)30 │ Hooks, topics, scripts, frameworks, editing DNA31 ▼32Phase 5: DATABASE (Notion)33 │ Creator profile + per-video entries + aggregated stats34 ▼35Phase 6: QUERY36 "What's working for @X right now?"37```3839---4041## Phase 1: Scrape (Apify)4243### Output44- CSV/JSON of all posts with metadata45- Sorted by performance (views descending)46- Tagged by content type4748---4950## Phase 2: Download Top Videos5152```bash53# Download S-Tier and A-Tier reels (top 20-30)54# For each video:55yt-dlp --write-info-json -o "creator_handle/%(id)s.%(ext)s" [VIDEO_URL]56```5758## Phase 3: Deconstruct Each Video5960For each downloaded video, run the full analysis stack:6162### 3a. Frame Extraction63```bash64# Standard: 1 frame every 3 seconds65ffmpeg -i video.mp4 -vf "fps=1/3" -q:v 2 frames/frame_%03d.jpg6667# Detailed (for editing style analysis): 1 frame every 0.5 seconds68ffmpeg -i video.mp4 -vf "fps=2" -q:v 2 frames/frame_%03d.jpg69```7071### 3b. Audio + Transcription72```bash73ffmpeg -y -i video.mp4 -vn -acodec pcm_s16le -ar 16000 audio.wav74# Transcribe with word timestamps75mlx_whisper.transcribe('audio.wav', path_or_hf_repo='mlx-community/whisper-large-v3-turbo', word_timestamps=True)76```7778### 3d. Emotion Detection (Hume AI)79- Run on audio: detect emotion peaks80- Map emotion arc across the video duration81- Identify: hook emotion, peak emotion, closing emotion8283### 3e. Video Understanding (Twelve Labs)84- Scene segmentation85- Action recognition86- Object detection87- Overall video classification8889---9091## Phase 4: Extract Intelligence (Per Video)9293For each video, produce a structured analysis:9495### Video Deconstruction Card9697```markdown98## Video: [Title/First Line]99**URL:** [Instagram URL]100**Posted:** [Date]101**Duration:** [Seconds]102**Performance:** [Views] views | [Likes] likes | [Comments] comments | [ER]% engagement103**Tier:** [S/A/B/C]104105### Hook (First 3 Seconds)106- **Text:** "[Exact opening words]"107- **Hook Type:** [Question / Bold Claim / Pattern Interrupt / Story / Stat / Controversy]108- **Visual:** [What's on screen in first 3 seconds]109- **Emotion:** [From Hume - curiosity, surprise, authority, etc.]110111### Topic112- **Category:** [AI Tools / Business / Lifestyle / Tutorial / etc.]113- **Subtopic:** [Specific angle]114- **Evergreen?** [E] Evergreen / [D] Dated / [T] Trending115116### Script Structure117- **Framework:** [Hook → Problem → Solution → CTA / Hook → Story → Lesson / etc.]118- **Full Script:** [Complete transcription]119- **Word Count:** [X words in Y seconds = Z WPM]120- **Key Phrases:** [Memorable lines]121122### CTA123- **Type:** [Comment keyword / Follow / Link in bio / Share / Save / None]124- **Exact CTA:** "[Their exact words]"125- **ManyChat trigger:** [If applicable]126127### Emotion Arc (from Hume)128- **Opening:** [emotion]129- **Peak:** [emotion at timestamp]130- **Close:** [emotion]131132### Content Market Fit Alignment133- **Which Corner:** [YOU / AUDIENCE / OFFER — which corner does this video serve?]134- **Worldview expressed:** [What belief/value does this video reveal?]135136### Recreate Prompt137- **Script template:** [Generalized version anyone could use]138- **Interview questions to ask:** [3-5 questions to get a client to produce similar content]139- **Image generation prompt:** [Nano Banana Pro prompt for thumbnail/visual]140- **Video generation prompt:** [Higgsfield/Kling prompt for animation]141```142143---144145## Phase 5: Database (Notion)146147## Phase 6: Query Interface148149## Client Intelligence (Extension for Viral Editz Clients)150151Same pipeline PLUS these additional fields:152153## Dave Compliance Notes154155### Database Purity156- **Creator Intelligence ≠ Council.** Council = their brain (frameworks, expertise, when to consult them). Creator Intelligence = their content machine (hooks, performance, editing style, format data). A creator like @ownease can exist in BOTH — Council for his course teachings, Creator Intelligence for his content patterns.157- **Client Intelligence ≠ Client Profiles.** Client Profiles = psychology, speech patterns, proven hooks (existing DB). Client Intelligence = performance tracking, video deconstruction, competitor matching, editing style analysis. They relate to each other (Client Intelligence entries link to Client Profiles).158159### Layer Placement160- Creator Intelligence DB → **Machine Layer** (HOW to execute: content patterns are tools)161- Video Deconstruction DB → **Machine Layer** (HOW to execute: deconstructed videos are reference)162- Hook Swipe File → Deferred (embedded in Video Deconstruction for now)163164### Safety165- All operations are ADDITIVE. No deletions. No restructuring.166- Re-scrapes ADD new data with dated Change Log entries, never overwrite.167168### Dave Gate Status169- Creator Intelligence: **PASSED** — solves real bottleneck of manual video pattern analysis170- Video Deconstruction: **PASSED** — enables systematic recreation and comparison171- Hook Swipe File: **DEFERRED** — not yet a proven bottleneck, hooks live in Video Deconstruction172173---174175176## Full Specification177178Complete details, decision trees, protocols, and implementation specs: [references/full-details.md](references/full-details.md)179180181## Change Log182- [2026-03-13]: Context Diet — split 430 lines into routing card (190 lines) + references/full-details.md (268 lines). Zero content deleted. By skill-diet.py.183184- 2026-02-06: Created. Source: Luis Carrillo brain dump session. Designed as the master extraction pipeline for both creators the user follows and Viral Editz clients. Integrates with Content Market Fit, AI Cookbook, Video Intelligence, and all content creation skills. Notion databases designed (Creator Intelligence, Video Deconstruction, Hook Swipe File).