indranilbanerjee/digital-marketing-pro / skills/content-engine
content-engine
VerifiedDraft content in brand voice through a gated pipeline: blogs, ads, emails. Brief only → content-brief. "write a blog post about X"
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 35.1 KB |
| accessibility.md | markdown | 3.5 KB |
| ad-copy.md | markdown | 4.5 KB |
| ai-content-quality.md | markdown | 4.9 KB |
| brand-voice.md | markdown | 4.5 KB |
| case-studies.md | markdown | 16.9 KB |
| content-calendar.md | markdown | 4.5 KB |
| content-decay.md | markdown | 4.5 KB |
| draft-deliverables.md | markdown | 5.1 KB |
| email-automation.md | markdown | 4.3 KB |
| email-infrastructure.md | markdown | 5.5 KB |
| email-sequences.md | markdown | 5.5 KB |
| evals/evals.json | config | 2.6 KB |
| landing-pages.md | markdown | 4.5 KB |
| multilingual.md | markdown | 4.7 KB |
| personalization.md | markdown | 20.0 KB |
| seo-content.md | markdown | 5.5 KB |
| social-content.md | markdown | 5.0 KB |
| video-scripting.md | markdown | 16.5 KB |
video-scripting.md
View on GitHub# Video Scripting Reference
## Platform-Specific Formats
| Platform | Aspect Ratio | Max Length | Optimal Length | Autoplay | Caption Support |
|----------|-------------|-----------|----------------|----------|-----------------|
| YouTube (long-form) | 16:9 | 12 hours | 8-15 minutes | No (click to play) | SRT, VTT, auto-generated |
| YouTube Shorts | 9:16 | 3 minutes | 30-45 seconds | Yes (in feed) | Auto-generated, burned-in recommended |
| TikTok | 9:16 | 10 minutes | 15-60 seconds | Yes (sound on) | Auto-generated, SRT, burned-in |
| Instagram Reels | 9:16 | 20 minutes (platform_specs.json: instagram.reel_max_seconds), reported; a reel over 3 minutes isn't recommended to new audiences | 15-30 seconds | Yes (sound off in feed) | Auto-generated, burned-in recommended |
| Instagram Stories | 9:16 | 60 seconds | 15 seconds | Yes (sound off) | Burned-in only |
| LinkedIn Video | 1:1 or 16:9 | 10 minutes | 30-90 seconds | Yes (sound off) | SRT upload, burned-in recommended |
| Facebook In-Feed | 16:9, 1:1, or 4:5 | 240 minutes | 15-60 seconds | Yes (sound off) | SRT, auto-generated |
| Facebook Stories | 9:16 | 3 to 90 seconds (Meta's Page Stories API) | 15 seconds | Yes (sound off) | Burned-in only |
**YouTube rules that change a script or a plan** (YouTube Help, read 2026-10-28):
- Shorts views count every start or replay, with no minimum watch time, since 2025-03-31; compare Shorts on "Engaged views" ([10059070](https://support.google.com/youtube/answer/10059070)).
- Repetitive or mass-produced videos (templates, one script reskinned) are "inauthentic content", ineligible for monetisation since the 2025-07-15 policy update ([1311392](https://support.google.com/youtube/answer/1311392)).
- Realistic AI-generated or altered footage must be disclosed at upload ("AI use"); YouTube may label files carrying C2PA metadata automatically ([14328491](https://support.google.com/youtube/answer/14328491)).
### Platform Behavioral Notes
1. **YouTube** — Viewers actively choose to watch; longer attention spans. Optimize for watch time and session duration. Thumbnails and titles drive clicks; the first 30 seconds determine retention.
2. **TikTok** — Sound-on environment; music and voiceover are expected. Algorithm rewards completion rate and rewatches. Authenticity outperforms polish.
3. **Instagram Reels** — Hybrid behavior; some sound-on, many sound-off. On-screen text is essential. Trending audio can boost distribution.
4. **LinkedIn** — Professional context; sound-off default. Burned-in captions are mandatory for engagement. Talking-head and thought-leadership formats perform best.
5. **Facebook** — Declining organic reach; paid distribution is primary. Sound-off default. Thumb-stopping visuals in the first frame are critical.
---
## Video Script Structures
| Structure | Pattern | When to Use |
|-----------|---------|-------------|
| AIDA | Attention > Interest > Desire > Action | Product launches, direct response ads |
| PAS | Problem > Agitate > Solve | Pain-point driven products, B2B solutions |
| Before-After-Bridge | Before state > After state > Bridge (product) | Transformation-focused products, fitness, SaaS |
| Problem-Solve-CTA | State problem > Present solution > Call to action | Short-form ads (15-30s), simple value props |
| Testimonial | Social proof hook > Customer story > Result > CTA | Trust-building, mid-funnel retargeting |
| Explainer (What-How-Why) | What it is > How it works > Why it matters | New product categories, complex offerings |
| Product Demo | Hook > Feature walkthrough > Key benefit > CTA | E-commerce, software, physical products |
| Listicle/Tips | Hook > Tip 1 > Tip 2 > Tip 3 > CTA | Educational content, thought leadership, organic social |
### Choosing a Structure
- For awareness campaigns with cold audiences, use AIDA or Before-After-Bridge to create desire.
- For consideration campaigns targeting warm audiences, use Explainer or Product Demo to educate.
- For conversion campaigns targeting hot audiences, use PAS or Testimonial to overcome objections.
- For organic/content marketing, use Listicle/Tips to deliver value and build authority.
---
## Hook Formulas (First 3 Seconds)
The first 3 seconds determine whether a viewer watches or scrolls. Every video script must open with a deliberate hook. Below are 12 proven patterns:
1. **Question Hook** — Open with a question the viewer wants answered.
- Example: "Did you know 73% of carts get abandoned before checkout?"
2. **Stat Hook** — Lead with a surprising or counterintuitive statistic.
- Example: "87% of marketers say video gives them positive ROI."
3. **Controversy Hook** — Challenge a common belief or practice.
- Example: "Stop posting on social media every day. Here's why."
4. **Before/After Hook** — Show the transformation immediately.
- Example: [Visual: messy dashboard] "This was our reporting..." [Visual: clean dashboard] "...and this is it now."
5. **Direct Address Hook** — Speak directly to the viewer's identity or situation.
- Example: "If you're a SaaS founder spending more than $10K/month on ads, watch this."
6. **Pattern Interrupt Hook** — Break expectations with an unexpected visual or statement.
- Example: [Person walks into frame and drops a stack of papers] "This is everything your team does manually that should be automated."
7. **Social Proof Hook** — Lead with credibility or numbers.
- Example: "10,000 marketers switched to this tool last quarter. Here's what happened."
8. **Fear/Urgency Hook** — Highlight a risk or time-sensitive opportunity.
- Example: "Google just changed its algorithm and most sites are about to lose traffic."
9. **Curiosity Gap Hook** — Tease information without revealing it.
- Example: "There's one setting in your ad account that's wasting 30% of your budget."
10. **Demonstration Hook** — Show the product or result immediately.
- Example: [Screen recording: 3 clicks to generate a report] "Watch how fast this is."
11. **Story Opener Hook** — Begin with a brief, relatable narrative.
- Example: "Last month, a client came to us spending $50K on ads with zero leads. Here's what we found."
12. **Bold Claim Hook** — Make a strong, specific promise.
- Example: "This framework doubled our conversion rate in 14 days."
### Hook Selection by Platform
- **TikTok/Reels:** Pattern interrupt, controversy, curiosity gap, bold claim (visual-first, fast-paced)
- **YouTube:** Question, story opener, stat hook (viewers chose to click, reward with depth)
- **LinkedIn:** Stat hook, direct address, social proof (professional credibility matters)
- **Facebook Ads:** Before/after, demonstration, fear/urgency (thumb-stopping in sound-off feed)
---
## Timestamp Annotation Format
Use timestamp annotations to define pacing and ensure every second has purpose. Standard format:
### 15-Second Script Template
```
0:00-0:03 HOOK — Grab attention (visual + text/VO)
0:03-0:10 CORE MESSAGE — Single key point or benefit
0:10-0:13 PROOF — Stat, testimonial snippet, or demo
0:13-0:15 CTA — Clear single action
```
### 30-Second Script Template
```
0:00-0:03 HOOK — Pattern interrupt or question
0:03-0:08 PROBLEM — Establish the pain point
0:08-0:18 SOLUTION — Introduce product/service with key benefit
0:18-0:25 PROOF — Social proof, demo, or result
0:25-0:30 CTA — Direct call to action with urgency
```
### 60-Second Script Template
```
0:00-0:03 HOOK — Strong opening to stop the scroll
0:03-0:10 CONTEXT — Set up the problem or situation
0:10-0:30 CORE CONTENT — Main message, features, or story
0:30-0:45 PROOF/SUPPORT — Testimonials, data, demonstrations
0:45-0:55 RECAP — Reinforce the key takeaway
0:55-1:00 CTA — Specific next step
```
### 2-Minute Script Template
```
0:00-0:05 HOOK — Compelling opening
0:05-0:15 SETUP — Problem or context establishment
0:15-0:45 POINT 1 — First key message or feature
0:45-1:15 POINT 2 — Second key message or benefit
1:15-1:35 POINT 3 — Third key message or proof
1:35-1:50 SUMMARY — Tie points together
1:50-2:00 CTA — Call to action
```
### 5-Minute+ Script Template
```
0:00-0:10 HOOK — Strong opening + preview of value
0:10-0:30 INTRO — Context, credibility, agenda
0:30-1:30 SECTION 1 — First major topic (soft CTA at end)
1:30-2:30 SECTION 2 — Second major topic
2:30-3:30 SECTION 3 — Third major topic (soft CTA at end)
3:30-4:15 SECTION 4 — Fourth major topic or case study
4:15-4:45 RECAP — Key takeaways summary
4:45-5:00 CTA — Strong closing call to action
```
---
## Visual Direction Notes
### Camera Direction Vocabulary
Use these standard terms in script annotations to communicate visual intent:
- **CU (Close-Up)** — Tight framing on face or product detail; conveys emotion or highlights specific features
- **WS (Wide Shot)** — Full scene establishing context, environment, or scale
- **MS (Medium Shot)** — Waist-up framing; standard for talking-head content
- **B-Roll** — Supplementary footage that visually supports the voiceover or main content
- **Lower Third** — Text overlay in the bottom third of the screen for names, titles, or key points
- **Text Overlay** — On-screen text reinforcing spoken words; essential for sound-off viewing
- **Split Screen** — Two frames side by side for comparison (before/after, competitor vs. product)
- **Transition** — Visual shift between scenes (cut, dissolve, swipe, zoom); match to platform style
- **Screen Recording** — Capture of software/app in use; standard for product demos and tutorials
- **Talking Head** — Single person speaking directly to camera; builds trust and personal connection
### B-Roll Cue Format
In scripts, annotate B-roll cues in brackets:
```
[B-ROLL: Team working at desks, overhead angle]
[B-ROLL: Close-up of hands typing on keyboard]
[B-ROLL: Product packaging being opened]
[B-ROLL: Customer using product in real environment]
```
### On-Screen Text Timing
- Display text for a minimum of 2 seconds or long enough to read twice at normal speed
- Maximum 6-8 words per text overlay for mobile viewing
- Animate text in on the beat of the voiceover — not before, not after
- Use contrasting background (semi-transparent bar or drop shadow) for readability
### Motion Graphics Triggers
Annotate motion graphics cues in scripts as:
```
[GFX: Animated stat counter — "10,000+ customers"]
[GFX: Logo reveal with tagline]
[GFX: Step 1/2/3 numbered progression]
[GFX: Price comparison table slide-in]
```
---
## Audio Direction
### Voiceover Pacing
- **Standard narration:** 130-150 words per minute for clear comprehension
- **Energetic/promotional:** 150-170 words per minute for urgency and excitement
- **Thoughtful/premium:** 110-130 words per minute for gravitas and authority
- **Quick-hit social (TikTok/Reels):** 160-180 words per minute to match platform energy
For a 60-second video at standard pacing, plan for approximately 130-150 words of script.
### Music Mood Mapping
| Video Tone | Music Style | Tempo (BPM) | Instruments |
|------------|------------|-------------|-------------|
| Upbeat/Energetic | Pop, electronic, indie | 120-140 | Synths, claps, guitar |
| Corporate/Professional | Ambient, light orchestral | 90-110 | Piano, strings, soft percussion |
| Emotional/Inspirational | Cinematic, acoustic | 70-100 | Piano, strings, vocals |
| Minimal/Clean | Lo-fi, ambient pads | 80-100 | Soft synths, minimal percussion |
| Urgent/Exciting | Driving electronic, rock | 130-160 | Drums, bass, distorted synths |
| Playful/Fun | Ukulele, whistling, bouncy | 110-130 | Acoustic guitar, xylophone, claps |
### Sound Effects Usage
- Use sound effects sparingly — 2-3 per 60-second video maximum
- Effective uses: whoosh on transitions, pop on text appearance, notification ding for CTA
- Avoid overuse; excessive sound effects feel amateurish
- Match sound effects to brand tone (tech brands: digital/clean; lifestyle brands: organic/natural)
### Silence as Emphasis
Strategic silence (0.5-1.5 seconds) after a key statement forces the viewer to process the message. Use before a major reveal, after a surprising statistic, or before the CTA. Silence is especially powerful in long-form content where viewers are accustomed to continuous audio.
---
## CTA Placement by Video Length
| Video Length | CTA Placement | CTA Type | Notes |
|-------------|--------------|----------|-------|
| 15 seconds | 0:13-0:15 (end only) | Single, direct | One action, no ambiguity |
| 30 seconds | 0:25-0:30 (end only) | Single, direct | Brief supporting text overlay |
| 60 seconds | 0:28-0:32 (mid) + 0:55-1:00 (end) | Soft mid + hard end | Mid-CTA can be verbal mention; end-CTA is visual + verbal |
| 2 minutes | 0:05 (tease) + 1:00 (mid) + 1:50-2:00 (end) | Tease + soft + hard | Tease: "Stay to the end for..."; mid: verbal; end: full CTA |
| 5+ minutes | Multiple soft CTAs + hard end CTA | Layered | Soft CTAs every 90-120 seconds; hard CTA in final 15 seconds |
### CTA Best Practices
1. **Be specific** — "Click the link in bio to download the free template" beats "Check it out"
2. **One primary CTA per video** — Multiple competing actions reduce conversion
3. **Verbal + visual** — Say the CTA and show it on screen simultaneously
4. **Reduce friction** — Tell the viewer exactly what happens after they take the action
5. **Match CTA to funnel stage** — Awareness: "Follow for more"; Consideration: "Watch this next"; Conversion: "Sign up now"
---
## Accessibility Requirements
Accessible video is not optional — it expands audience reach, improves engagement metrics, and is legally required in many contexts.
### Mandatory Elements
1. **Closed Captions** — Provide for every video, on every platform. Use platform-native caption tools or upload SRT/VTT files. Auto-generated captions must be reviewed and corrected for accuracy before publishing.
2. **Burned-In Captions** — Required for platforms that do not reliably display caption files (Instagram Stories, TikTok, most social feeds). Style guidelines:
- Font: Sans-serif, bold weight, minimum 24pt equivalent on mobile
- Contrast: White text on semi-transparent dark background, or outlined text
- Position: Lower third of frame, avoiding overlap with platform UI elements
- Timing: Sync to speech with 0.5-1 second display buffer
3. **Audio Descriptions** — When critical information is conveyed only visually (charts, on-screen text not read aloud, visual demonstrations), provide audio description either as a separate audio track or by scripting narration that describes what is shown.
4. **Transcripts** — Make full text transcripts available for long-form content. Post in video description, linked document, or companion blog post.
5. **Color Contrast for On-Screen Text** — Maintain WCAG AA minimum contrast ratio (4.5:1 for normal text, 3:1 for large text) for all text overlays, lower thirds, and graphics.
6. **Alternative Text** — When embedding video on websites, provide descriptive alt text for the video thumbnail and a text summary of video content for screen readers.
---
## Platform Technical Specs
| Platform | Aspect Ratio | Min Resolution | Max Resolution | Max File Size | Max Length | Caption Format | Thumbnail |
|----------|-------------|---------------|---------------|--------------|-----------|----------------|-----------|
| YouTube | 16:9 | 426x240 | 3840x2160 (4K) | 256 GB | 12 hours | SRT, VTT, SBV | 1280x720 JPG/PNG, <2MB |
| YouTube Shorts | 9:16 | 1080x1920 | 1080x1920 | 256 GB | 3 minutes | Auto-generated | Auto-selected from video |
| TikTok | 9:16 | 720x1280 | 1080x1920 | 287 MB (web), 72 MB (app) | 10 minutes | SRT, auto-generated | Auto-selected, can edit |
| Instagram Reels | 9:16 | 720x1280 | 1080x1920 | 4 GB | 20 minutes, reported (keep to 3 for reach) | Auto-generated, burned-in | 1080x1920 from video |
| Instagram Stories | 9:16 | 720x1280 | 1080x1920 | 4 GB | 60 seconds | Burned-in only | N/A |
| LinkedIn | 1:1, 16:9, 9:16 | 256x144 | 4096x2304 | 5 GB | 10 minutes | SRT upload | Auto-selected |
| Facebook In-Feed | 16:9, 1:1, 4:5 | 720p | 4K | 10 GB | 240 minutes | SRT, auto-generated | 1200x675 or 1080x1080 |
| Facebook Stories | 9:16 | 540x960 | 1080x1920 | Meta states none (photos 10 MB) | 3 to 90 seconds | Burned-in only | N/A |
### File Format Notes
- **Preferred codec:** H.264 with AAC audio across all platforms
- **Frame rate:** 24-30 fps standard; 60 fps for action/demo content
- **Bitrate:** 10-20 Mbps for 1080p; 35-45 Mbps for 4K
- **Audio:** Stereo, 128-256 kbps AAC, -14 LUFS to -16 LUFS for loudness normalization
- **Export tip:** Always export at the highest quality available and let platforms handle compression; uploading pre-compressed files results in double compression artifacts
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |