Deconstruct video ad creatives into marketing dimensions using Gemini AI. Extracts hooks, social proof, CTAs, target audience, emotional triggers, urgency tactics, and more. Use when analyzing competi
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
AI-powered deconstruction of video ad creatives into actionable marketing insights.
# Required for Gemini GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
pip install vertexai
from scripts.deconstructor import AdDeconstructor from scripts.models import ExtractedVideoContent import vertexai from vertexai.generative_models import GenerativeModelInitialize Vertex AI
vertexai.init(project="your-project-id", location="us-central1") gemini_model = GenerativeModel("gemini-1.5-flash")
Create deconstructor
deconstructor = AdDeconstructor(gemini_model=gemini_model)
Create extracted content (from video-ad-analyzer or manually)
content = ExtractedVideoContent( video_path="ad.mp4", duration=30.0, transcript="Tired of messy cables? Meet CableFlow...", text_timeline=[{"at": 0.0, "text": ["50% OFF TODAY"]}], scene_timeline=[{"timestamp": 0.0, "description": "Person frustrated with tangled cables"}] )
Generate summary
summary = deconstructor.generate_summary( transcript=content.transcript, scenes="0.0s: Person frustrated with tangled cables", text_overlays="50% OFF TODAY" ) print(summary)
# Deconstruct all marketing dimensions def on_progress(fraction, dimension): print(f"Progress: {fraction*100:.0f}% - Analyzed {dimension}")analysis = deconstructor.deconstruct( extracted_content=content, summary=summary, is_gaming=False, # Set True for gaming ads on_progress=on_progress )
Access dimensions
for dimension, data in analysis.dimensions.items(): print(f"\n{dimension}:") print(data)
Product/App: CableFlow Cable OrganizerKey Features: Magnetic design: Keeps cables organized automatically Universal fit: Works with all cable types Premium materials: Durable silicone construction
Target Audience: Tech users frustrated with cable management
Call to Action: Order now and get 50% off
{ "spoken_hooks": { "elements": [ { "hook_text": "Tired of messy cables?", "timestamp": "0:00", "hook_type": "Problem Question", "effectiveness": "High - directly addresses pain point" } ] }, "social_proof": { "elements": [ { "proof_type": "User Count", "claim": "Over 1 million happy customers", "credibility_score": 7 } ] }, # ... more dimensions }
| Dimension | What It Extracts |
|---|---|
| Opening hooks from transcript |
| Attention-grabbing visuals |
| On-screen text hooks |
| Testimonials, user counts, reviews |
| Limited time offers, stock warnings |
| Fear, desire, belonging, etc. |
| Pain points and solutions |
| Call-to-action effectiveness |
| Who the ad targets |
| What makes product special |
Edit prompts in
prompts/marketing_analysis.mdNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.