Agent skill

Video Narrative Arc

by AnastasiyaW in AnastasiyaW/codex-claude-code-config

Proven narrative arc templates for product videos and ads. An agent skill from AnastasiyaW/codex-claude-code-config.

MITAuto-check passedMedia & Creative

Install Video Narrative Arc

skills CLI
$ npx skills add AnastasiyaW/codex-claude-code-config --skill video-narrative-arc -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AnastasiyaW/codex-claude-code-config video-narrative-arc --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AnastasiyaW/codex-claude-code-config.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/video-production/video-narrative-arc .claude/skills/video-narrative-arc && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
video-narrative-arc
GitHub stars
154
Token cost
~2.3k tokens
SKILL.md length
545 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Proven narrative arc templates for product videos and ads. An agent skill from AnastasiyaW/codex-claude-code-config.

  • Video structure
  • SKILL.md covers Rule #1: Brief First, Template Selection, Template 1: Pattern Interrupt… and Template 2: Problem-Solution…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • 15 second video

What it does

Video Narrative Arc is an agent skill from AnastasiyaW/codex-claude-code-config. Proven narrative arc templates for product videos and ads. Use when: 'write script', 'video structure', 'narrative arc', 'scene plan', 'storyboard', '15 second video', '30 second video', '60 second video', 'how to structure the video', 'video script template'. Provides beat-by-beat templates with timing, emotional arc mapping, hook formulas, and pacing rules. Covers 10s-90s formats for social, product demos, launches, and pitches. Do NOT use to judge or score an already-written script (use script-evaluator), to…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production, Video scripts and shorts and Comics and storyboards. It works with Remotion. The repository describes itself as: Claude Code, Codex, and multi-agent configuration system: principles, hooks, skills, and workflow patterns for AI-assisted development. The licence is MIT.

When your agent uses it

  • Video structure
  • 15 second video
  • 30 second video
  • 60 second video

Example prompts

  • “write script”
  • “video structure”
  • “narrative arc”
  • “/video-narrative-arc”

What it can do on your machine

Read from SKILL.md and the folder at commit 67709af. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Video Narrative Arc loads about 2.3k tokens when it runs. Until then it costs about 183 tokens; SKILL.md has 545 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~183
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AnastasiyaW/codex-claude-code-config at commit 67709af, republished under its MIT licence (© AnastasiyaW). 545 words, ~2,285 tokens.

Download SKILL.mdSave it as .claude/skills/video-narrative-arc/SKILL.md (or your agent's skills folder).
name
video-narrative-arc
description
Proven narrative arc templates for product videos and ads. Use when: 'write script', 'video structure', 'narrative arc', 'scene plan', 'storyboard', '15 second video', '30 second video', '60 second video', 'how to structure the video', 'video script template'. Provides beat-by-beat templates with timing, emotional arc mapping, hook formulas, and pacing rules. Covers 10s-90s formats for social, product demos, launches, and pitches. Do NOT use to judge or score an already-written script (use script-evaluator), to derive the product insight/brief from scratch (use product-meaning-extractor), or to render the video in code (use remotion-production-guide); this stage only produces the structured script/beats.

Video Narrative Arc Templates

Proven narrative structures for product videos. Pick a template, fill slots from your Product Brief, get a timestamped script with emotional beats.

Rule #1: Brief First

ALWAYS create a Product Brief (use product-meaning-extractor) BEFORE choosing a template. Without a brief, you'll write generic feature lists.

Template Selection

DurationBest ForTemplateEmotional Arc
10-15sSocial ads, teasersPattern InterruptSurprise → Curiosity → Action
15-20sProduct awarenessProblem-Solution FlashPain → Relief → Action
30sProduct demosHook-Pain-Demo-Proof-CTAAttention → Recognition → Desire → Trust → Action
45-60sLaunches, explainersApple Keynote MiniUnderstanding → Frustration → Hope → Amazement → Delight
60-90sBrand stories, pitchesFull Story ArcEmpathy → Tension → Discovery → Wonder → Inspiration

Template 1: Pattern Interrupt (10-15s)

For: TikTok, Reels, YouTube Shorts, social ads.

[0-3s] INTERRUPT
  Break the scroll. Unexpected visual or bold text on dark bg.
  Use: provocative question, shocking stat, or visual contrast.
  Example: "Why are you still [painful manual task]?"

[3-7s] CURIOSITY GAP
  Show what's possible. Product in action, before→after, result.
  One phrase that captures the transformation.
  Example: Split-screen transformation in real time.

[7-12s] PROMISE + CTA
  Product name + key benefit + action.
  Example: "[Product]. [One-line value]. Try free."

Key rule: First frame must have useful/surprising information. No logos, no gradients, no decorative intros.


Template 2: Problem-Solution Flash (15-20s)

For: Instagram/Facebook ads, product awareness.

[0-3s] HOOK - Customer pain in THEIR words
  Dark bg, large text, one line from Customer Language Bank.
  Example: "45 minutes. Per. Photo."
  BEAT: TENSION

[3-8s] AGITATE - Stack the problems (2-3 rapid pain points, 1.5s each)
  Example: "Scratches. Noise. Shadows. Every. Single. Time."
  BEAT: FRUSTRATION PEAK

[8-10s] PIVOT
  Visual shift (dark→light, blur→sharp). Two words max.
  Example: "Not anymore." / "Until now." / "There's a better way."
  BEAT: RELIEF BEGINS

[10-16s] SOLUTION - Product in action
  Show the unique mechanism (from brief), not just the name.
  Example: "AI retouching. Original resolution. Editable .PSD."
  BEAT: DESIRE

[16-20s] CTA
  Low-friction call to action. Logo + URL + free offer.
  Example: "Try free. No signup. [url]"
  BEAT: ACTION

Template 3: Hook-Pain-Demo-Proof-CTA (30s)

For: Product demos, YouTube pre-rolls.

[0-4s] HOOK - The boldest claim you can back up
  Core insight from brief. NOT a feature - a worldview.
  Example: "The last time you'll [painful task] by hand."
  BEAT: ATTENTION

[4-10s] PAIN - The enemy, made visceral
  Show the painful process. Use customer language.
  Specific numbers. Speed up boring tasks to emphasize tedium.
  Example: Clock ticking, manual work, frustration faces.
  BEAT: RECOGNITION ("that's me!")

[10-20s] DEMO - Solution + unique mechanism
  Product in action. Start slow (dramatic reveal), then quick feature hits.
  Show HOW it works, not just THAT it works.
  3-4 features max, each getting 2-3 seconds.
  BEAT: DESIRE (building)

[20-26s] PROOF - Why believe it
  Stats, logos, testimonials, specific numbers from brief.
  Example: "Original DPI. Used by 500+ studios. .PSD with layers."
  BEAT: TRUST

[26-30s] CTA - Specific and low-friction
  Logo + URL + offer + animated button.
  What to do RIGHT NOW, not someday.
  Example: "800 free tokens. No signup. [url]"
  BEAT: ACTION

Template 4: Apple Keynote Mini (45-60s)

For: Product launches, explainer videos. The premium option.

[0-5s] THE PROBLEM WITH TODAY
  Clean text on dark bg, slow fade. Calm, authoritative tone.
  "The problem with [category] today..."
  BEAT: SHARED UNDERSTANDING

[5-12s] THE REALITY
  2-3 scenes showing current painful workflow.
  Each problem appears with visual authority (large type, pause).
  "Manual. Slow. Inconsistent. Expensive."
  BEAT: FRUSTRATION BUILDS

[12-15s] THE VISION
  Visual shift (dark→light or reverse). This is the hinge.
  "What if..." / "We asked: what if..." / "Imagine..."
  BEAT: HOPE

[15-30s] THE SOLUTION (longest section)
  Product demo. 3-4 features, one at a time.
  Each feature: name + real benefit (not just feature name).
  Pacing: slow reveals. One feature = one breath. Don't rush.
  BEAT: PROGRESSIVE AMAZEMENT

[30-40s] THE PROOF
  Numbers, logos, before/after comparisons.
  2-3 strongest proof points from brief.
  BEAT: CONFIDENCE

[40-48s] ONE MORE THING (optional but powerful)
  Surprise feature or unexpected benefit they didn't see coming.
  "And it's free to try. No signup required."
  BEAT: DELIGHT

[48-60s] CTA
  Logo animation + URL + memorable closing line.
  "[Product] - [tagline]."
  BEAT: RESOLUTION

Template 5: Full Story Arc (60-90s)

For: Brand stories, investor pitches, deep explainers.

ACT 1: THE WORLD (0-20s)
  [0-5s]   Establish WHO this is for (specific persona, not generic)
  [5-12s]  Their daily struggle (use "Before" from brief)
  [12-20s] The breaking point - why NOW something must change

ACT 2: THE CHANGE (20-55s)
  [20-25s] Discovery - product enters the story (not as hero, as guide)
  [25-40s] The journey - seeing it work (features as story beats, not list)
  [40-50s] Transformation - before vs after side-by-side
  [50-55s] Proof - numbers, testimonials, authority

ACT 3: THE NEW WORLD (55-90s)
  [55-65s] Life after - what's possible now (use "After" from brief)
  [65-75s] Bigger vision - beyond the product, what world are we building?
  [75-90s] CTA + logo + resolution

Hook Formulas (first 3 seconds)

The hook is 80% of whether someone watches. Spend 80% of script time on the first 3 seconds.

FormulaExampleWhen to Use
Shocking stat"87% of [role] spend 3+ hours on [task]"When you have hard data
Provocative question"Why are you still doing this by hand?"When the pain is universal
Bold claim"The last time you'll [painful task]"When you can prove it
Customer quote"[Verbatim pain phrase from reviews]"When you have real language
Before/AfterShow transformation, no wordsWhen visual impact is strong
Pattern interruptUnexpected visual that stops scrollingSocial media specifically
Countdown"In 8 seconds, this photo will be perfect"When speed is the value prop
Contrarian"Everyone says [X]. They're wrong."When positioning against status quo

Script Writing Rules

Show full SKILL.md (234 more words)Show less
Text on Screen
  • Max 7 words on screen at any time
  • Reading speed: 150 WPM = 2.5 words/second
  • 3-word phrases hit hardest: "Upload. Process. Done."
  • Text readable for min 2 seconds AFTER animation completes
  • NEVER animate text while expecting reading
Power Words vs Kill Words

Use: Free, New, You, Instantly, Proven, Discover, Secret, Because, Now, Imagine Kill: Revolutionary, Innovative, Cutting-edge, World-class, Seamless, Leverage, Synergy, Disrupt

Tension Rules
  • Every scene needs tension (contrast, scarcity, curiosity, authority gap)
  • No tension = flat video. No exceptions.
  • If a scene feels boring: add a surprising stat, customer pain quote, or visual contrast
Pacing
  • Fast (2-3s cuts): problems, feature montage, social proof
  • Slow (5-8s holds): product reveal, hero moment, emotional beat
  • Never more than 3 fast cuts without a slow breath
  • The most important moment gets the MOST time, not the least
  • After every fast section, add one slow "breathing" shot
Language
  • "You" > "We" (customer-first, always)
  • Customer language > clever copywriting
  • Concrete > abstract ("45 minutes" > "a long time")
  • If it sounds like a brochure, rewrite it
  • If it sounds like a text to a friend, it's closer

Gotchas

  • Template != formula. Adapt timing to your content
  • If template feels forced, simplify: 3 strong scenes > 7 weak ones
  • The brief is the source of truth, not the template
  • Don't use Template 5 (Full Story Arc) for a 15-second ad. Match format to platform
  • "One more thing" only works if the surprise is genuinely unexpected

© AnastasiyaW, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/video-production/video-narrative-arc of AnastasiyaW/codex-claude-code-config.

Open the folder on GitHubat commit 67709af

Compare with similar skills

Video Narrative Arc next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Video Narrative Arc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video Narrative Arc this skillAnastasiyaW/codex-claude-code-config154—~2.3kAutomated safety check: PassMIT
Remotion VideoTechNomadCode/AI-Product-Development-Toolkit1k—~1.1kAutomated safety check: PassMIT
Video PlanMagicCube/agentara5161 repos~2.6kAutomated safety check: PassNone
44 Brief Video Editorminhnv0807/ai-business-skills609—~1.9kAutomated safety check: PassMIT
Demo Produceryonatangross/orchestkit292—~2.6kAutomated safety check: NotesMIT
Scripting And Storyboardingsocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT

Similar skills

  • Remotion Video

    TechNomadCode/AI-Product-Development-Toolkit

    Make a short video about a product or brand (promo, launch, explainer, demo or social clip) entirely in code with Remotion, from idea to a rendered MP4 with sound.

    1k GitHub stars~1.1k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Video Plan

    MagicCube/agentara

    Plan short-form video, vlog, travel, lifestyle, documentary, or cinematic social video scripts by negotiating duration, choosing a story arc and visual style, then splitting the film into timed…

    516 GitHub starsUsed in 1 repo~2.6k tokens
    Media & CreativeAuto-check passed
  • 44 Brief Video Editor

    minhnv0807/ai-business-skills

    Dung khi da co y tuong va can huong dan NGUOI QUAY hoac NGUOI DUNG PHIM — storyboard tung beat, footage phai quay, chu chay tren man hinh, nhac, nhip cat, end-frame CTA va spec xuat theo kenh.

    609 GitHub stars~1.9k tokensUpdated 29 days ago
    Media & CreativeAuto-check passed
  • Demo Producer

    yonatangross/orchestkit

    Universal demo video creator for skills, agents, plugins, tutorials, CLI commands, and code walkthroughs.

    292 GitHub stars~2.6k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Scripting And Storyboarding

    social-media-skills/skills

    The pre-production system — turn a video idea into a shootable, editable plan: the two-column AV script, the storyboard as a decision document, the numbered shot list, the batch-shoot plan, and the…

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Shorts

    AgriciDaniel/claude-shorts

    Interactive longform-to-shortform video creator. An agent skill from AgriciDaniel/claude-shorts.

    219 GitHub stars~3.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check: notes

More from AnastasiyaW/codex-claude-code-config

All 50 skills in this repo
  • Bug Reproducer

    AnastasiyaW/codex-claude-code-config

    Find likely software bugs in a codebase, rank concrete bug candidates, and prove or reject them with focused regression tests before proposing a fix.

    154 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Motion Framer

    AnastasiyaW/codex-claude-code-config

    A skill your agent uses when implementing Motion or Framer Motion in React/JavaScript: interactive UI components, micro-interactions, gestures, layout or page transitions, and scroll-based animation.

    154 GitHub starsUsed in 1 repo~5.2k tokens
    Auto-check passed
  • Proof Verify

    AnastasiyaW/codex-claude-code-config

    Plan-based verification - freeze acceptance criteria before building, then verify after with an independent fresh-context agent (the builder must not verify their own work).

    154 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Workflow Orchestration

    AnastasiyaW/codex-claude-code-config

    Написание и запуск Claude Code dynamic workflows (JS-оркестратор субагентов).

    154 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Notebooklm Grounded Research

    AnastasiyaW/codex-claude-code-config

    A skill your agent uses when: NotebookLM, notebooklm MCP, large documentation sets, courses, books, papers, or citation-backed research are mentioned.

    154 GitHub stars~2.4k tokensUpdated today
    Auto-check: warnings
  • Deepseek Provider Contract

    AnastasiyaW/codex-claude-code-config

    Validate a proposed DeepSeek API integration before any key or project context is sent: check thinking-mode tool-call history, strict-schema assumptions, bounded output, and provider data boundaries.

    154 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Video Narrative Arc

What does Video Narrative Arc do?

Proven narrative arc templates for product videos and ads. An agent skill from AnastasiyaW/codex-claude-code-config. Video Narrative Arc is an agent skill from AnastasiyaW/codex-claude-code-config. Proven narrative arc templates for product videos and ads.

When should I use Video Narrative Arc?

Video Narrative Arc fits situations like: video structure; 15 second video; 30 second video; 60 second video.

How do I install Video Narrative Arc in Claude Code?

Run `npx skills add AnastasiyaW/codex-claude-code-config --skill video-narrative-arc -a claude-code`. Or copy the skill folder (skills/video-production/video-narrative-arc in AnastasiyaW/codex-claude-code-config) into .claude/skills/video-narrative-arc in your project. Claude Code loads it when a task matches its description.

How do I install Video Narrative Arc in Codex?

Run `npx skills add AnastasiyaW/codex-claude-code-config --skill video-narrative-arc -a codex`. Or copy the skill folder (skills/video-production/video-narrative-arc in AnastasiyaW/codex-claude-code-config) into .agents/skills/video-narrative-arc in your project. Codex loads it when a task matches its description.

Can I use Video Narrative Arc in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AnastasiyaW/codex-claude-code-config --skill video-narrative-arc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-narrative-arc, .gemini/skills/video-narrative-arc, .github/skills/video-narrative-arc and .opencode/skills/video-narrative-arc in your project.

What does Video Narrative Arc need to run?

SKILL.md names no scripts, command-line tools or credentials: Video Narrative Arc is instructions for the agent only.

Does Video Narrative Arc access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Video Narrative Arc safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Video Narrative Arc use?

Video Narrative Arc is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Video Narrative Arc use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Video Narrative Arc?

Skills that share tags, products or a category with Video Narrative Arc: Remotion Video (TechNomadCode/AI-Product-Development-Toolkit, 1k stars), Video Plan (MagicCube/agentara, 516 stars), 44 Brief Video Editor (minhnv0807/ai-business-skills, 609 stars) and Demo Producer (yonatangross/orchestkit, 292 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video Narrative Arc?

AnastasiyaW (a GitHub user) maintains it in AnastasiyaW/codex-claude-code-config, which has 154 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.

Source: AnastasiyaW/codex-claude-code-config on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.