slideshow-script

/slideshow-script — Narrative Script Generation

Generate 5 different narrative scripts from a single positioning angle. Each script uses a different storytelling framework, producing 5 publishable pieces of content instead of 5 variations of 1 script.

For scripting frameworks reference, see references/frameworks.md. For content spec YAML schema, see references/content-spec-schema.md.

Why 5 Scripts, Not 5 Layouts

Old model:  1 script × 5 visual layouts = 1 usable output (pick 1, waste 4)
New model:  5 scripts × 5 visual layouts = 5 usable outputs (post all 5)

Each script has a DIFFERENT narrative, DIFFERENT hook, DIFFERENT proof points. When paired with /paper-marketing, each agent gets a unique script AND a unique design direction.

Workflow

Phase 1: Load Brand Context

Read in parallel (if they exist):

• brand/positioning.md — available angles, headlines, proof points
• brand/audience.md — pain points, desires, language patterns
• brand/voice-profile.md — tone, vocabulary, do's/don'ts, signature phrases

If any files are missing, the skill still works — see Progressive Enhancement below for how to handle zero-context and partial-context scenarios.

Phase 2: Select Positioning Angle

If the user hasn't specified an angle, present the available angles from brand/positioning.md:

"Which positioning angle should I write 5 scripts for?"

[List angles from positioning.md with their headlines]

Options:
1-N. Select a specific angle
N+1. "Use the primary angle"

Phase 3: Generate 5 Scripts

For the selected positioning angle, generate 5 narratively distinct scripts — one per framework:

Each script includes:

• Hook (slide 1) — the first thing seen, must grab in 1-3 seconds
• 5-7 slides — each with type annotation (stat, anchor_word, emotional_pivot, cascade, cta, logo_intro)
• CTA (final slide) — clear action with URL/handle
• Animation hints — spring preset suggestion per slide (bouncy, smooth, heavy, snappy)

Script generation rules:

• All 5 must use the SAME positioning angle but tell DIFFERENT stories
• No two scripts should share the same hook
• Each script should use different proof points from the positioning doc
• Voice rules from voice-profile.md apply to ALL scripts
• Slide count can vary (5-9) based on what the narrative needs

Phase 4: Match Scripts to Visual Directions

Each script gets a recommended visual direction for /paper-marketing:

These are recommendations — the user can override.

Phase 5: Present for Approval

Use AskUserQuestion to show all 5 scripts with their visual direction:

"Here are 5 narrative scripts for '{angle_name}', each using a different storytelling framework:"

1. **AIDA** (→ Typographic): "{hook}" — Attention grab → feature interest → desire trigger → CTA
2. **PAS** (→ Contrast Play): "{hook}" — Pain → twist → relief
3. **BAB** (→ Atmospheric): "{hook}" — Before/after transformation
4. **Star-Story-Solution** (→ Editorial): "{hook}" — Story arc → resolution
5. **Stat-Flip** (→ Data-Led): "{hook}" — Shocking stat → reframe

Options:
1. "All 5 look great" — write all 5 content specs
2. "Regenerate #{n}" — rewrite a specific script
3. "Change the angle" — try a different positioning angle
4. "Edit a script" — modify specific slides
5. "Only use 3 of these" — select a subset

Phase 6: Write Content Spec YAMLs

For each approved script, write a structured YAML file:

Path: marketing/content-specs/{project}-{framework}.yaml

Example: marketing/content-specs/lumi-aida.yaml

See references/content-spec-schema.md for the full schema.

spec_version: 1
project: lumi
content_type: tiktok-slideshow
scripting_framework: AIDA
platform:
  name: tiktok
  width: 1080
  height: 1920
  aspect: "9:16"
positioning_angle: "The 30-Second Active Gate"
visual_direction: typographic
slides:
  - index: 1
    type: stat
    headline: "30"
    subhead: "seconds."
    body: null
    animation_hint: spring_bouncy
    role: hook
  - index: 2
    type: anchor_word
    headline: "Breathe in"
    subhead: "That's how long five deep breaths take."
    body: null
    animation_hint: spring_heavy
    role: interest
  # ... more slides
  - index: 7
    type: cta
    headline: "lumi.com"
    subhead: "Presence before everything."
    body: null
    animation_hint: spring_smooth
    role: action
cta:
  url: "lumi.com"
  tagline: "Presence before everything."
  handle: "@lumi"
voice_constraints:
  tone: "calm, certain, mindful"
  avoid: ["hype", "guilt", "exclamation marks"]
  signature_phrases: ["Take 5 breaths. Unlock your phone.", "Presence before everything."]

Phase 7: Summary

Report what was written:

5 content specs written to marketing/content-specs/:
  1. lumi-aida.yaml (7 slides, Typographic)
  2. lumi-pas.yaml (6 slides, Contrast Play)
  3. lumi-bab.yaml (7 slides, Atmospheric)
  4. lumi-story.yaml (8 slides, Editorial)
  5. lumi-statflip.yaml (5 slides, Data-Led)

Next: Run /paper-marketing to design each script, or /tiktok-slideshow for the full pipeline.

Standalone Usage

This skill works independently from any orchestrator:

• /slideshow-script alone → generates scripts for manual design work
• /slideshow-script → /paper-marketing → manual export (no video)
• /slideshow-script → /content-atomizer → repurpose scripts as text posts
• /slideshow-script → /email-sequences → use narratives in email campaigns

Progressive Enhancement

This skill works at three levels of context:

1. Zero context — No brand files. Ask the user for: product name, one-sentence description, target audience, and the key benefit. Generate scripts from that. They'll be generic but functional.
2. Partial context — Only positioning.md exists. Generate scripts from the positioning angles. Copy will be accurate but may lack voice personality.
3. Full context — All three brand files exist (positioning.md, audience.md, voice-profile.md). Scripts use the right angles, speak to the right pain points, and sound like the brand.

Anti-Patterns

• Same hook across scripts — The whole point of 5 scripts is 5 chances to grab attention differently. If two scripts start with a question hook, you've wasted one. A viewer who scrolled past hook A might stop for hook B — but only if B looks and sounds different.
• Recycled proof points — Reusing the same stat in multiple scripts means a viewer who sees script 2 after script 1 hears the same argument. Each script should use different proof points from positioning.md so every post adds new information.
• Generic voice — "Transform your life" could be any brand on any platform. Viewers tune it out because they've seen it a thousand times. Using the exact vocabulary and signature phrases from voice-profile.md makes the content feel authored and recognizable.
• Platform-specific copy in scripts — Scripts are the narrative layer, not the design layer. Writing "swipe right" or "link in bio" locks the script to one platform. Keep scripts platform-agnostic so the same narrative works for TikTok, Instagram, YouTube Shorts, or any other format.
• Too many slides — Every slide the viewer must sit through is friction. If a slide doesn't advance the narrative toward the CTA, it's a drop-off point. 5-7 slides usually hits the sweet spot for social content.
• Ignoring the framework — Each framework works because of its specific psychological structure. AIDA builds desire before asking for action. PAS makes pain visceral before offering relief. Blending frameworks dilutes the psychological effect that makes each one work.

Edge Cases

• positioning.md missing — Ask the user: "What's the main angle or benefit you want to highlight?" Use their answer as the positioning angle. Offer to run /positioning-angles to build proper angles.
• Only 1-2 proof points available — Generate fewer scripts (3 instead of 5) and tell the user which frameworks were dropped and why. Quality over quantity.
• User wants fewer than 5 scripts — Respect the request. Ask which frameworks they want, or recommend the best 2-3 for their content type.
• User wants a framework not in the list — Accept custom frameworks. Ask for the structure (what are the phases?) and generate a script following that structure.
• Brand voice conflicts with framework — If the brand voice is "calm, no hype" but PAS requires agitation, dial the agitation to match the voice. Agitate with quiet observations, not exclamation marks.

Principles

• 5 narratives, not 5 variations — every output should be publishable
• Frameworks enforce diversity — AIDA and PAS produce fundamentally different stories
• Content spec is the contract — downstream skills read YAML, not prose
• Archetype annotations matter — type: stat tells Paper agents AND Remotion what to emphasize
• Voice rules are non-negotiable — all 5 scripts must sound like the brand