---
name: video-producer
description: Produce a short narrated mp4 from any vault artifact (wiki article, KB, project, journal entry, or URL). Drives a headless browser, generates voiceover, composes the file.
allowed-tools: create_video search_vault query_knowledge
title: Video Producer — narrated screen-recording walkthroughs
category: creative
status: active
metadata:
  triggers:
  - make a video
  - make a video about
  - narrate this
  - narrate my
  - create a video
  - record a walkthrough
  - walkthrough video
  - video about
  - demo video
  - explain this in a video
  - video tour of
  priority: 6
---
## Instructions

Produce a short narrated mp4 from any vault artifact. The user names a target ("my Volvo wiki page", "the general KB", "Project Phoenix"); you resolve it, draft a scene outline, and call `create_video`. The tool handles the headless browser, voiceover, and composition — your job is choosing what to feature and how to narrate it.

1. **Resolve the target.** The user may say "my Volvo article" or "the KB on AI". Use `search_vault` or `query_knowledge` to confirm the slug. If ambiguous, ask ONE question — never three. Once resolved, the target string is one of:
   - `wiki:<slug>` (specific wiki article)
   - `kb:<slug>` (whole knowledge base — walks featured articles)
   - `project:<slug>` (project page + linked goals/tasks/recent activity)
   - `journal:YYYY-MM-DD` (a specific day)
   - `url:https://...` (any URL — including external pages)

2. **Pick the style.** Three presets in `config/styles.yaml`:
   - `tutorial` — slower pacing, didactic tone, longer captions. For "how do I use X" videos.
   - `promo` — faster, punchier, energetic. For "look what you can do" videos.
   - `walkthrough` — mid-pace, conversational. The default — use it unless the user explicitly asks otherwise.

3. **Pick the duration.** Default 60 seconds for wiki articles, 90 for KBs, 60 for projects, 45 for journal entries, 60 for URLs. Cap at 180 seconds — longer videos rarely get watched. The user can override.

4. **Draft a scene outline before calling the tool.** For the user's preview, sketch:
   - 4-12 scenes max (more = each scene too short to land)
   - One sentence narration per scene (NOT a paragraph — videos are tight)
   - The visual focus per scene (heading X, scroll to section Y)
   The tool's adapter will refine this from the artifact's actual content; your outline is the user-facing preview.

5. **Call `create_video`.** Pass the resolved target, duration, voice (default `liam`), and style. The tool returns:
   - `path` — the mp4 file path on disk
   - `scenes` — actual scene list used (may differ from your draft if the adapter pruned)
   - `duration` — actual mp4 duration in seconds
   - `narration_word_count` — total words spoken

6. **Report the outcome.** Tell the user where the file lives and how long it is. If the tool returned warnings (e.g. "TTS provider degraded to piper-tts offline"), surface them — don't hide.

## Rules

- **Never invent content.** Narration must come from what's actually in the artifact. If the wiki article says nothing about X, the video doesn't say anything about X. The agent that produces videos with fabricated facts loses trust instantly. Use `query_knowledge` if you need to ground a claim.
- **Never use special characters in narration text.** No em-dashes (—), en-dashes (–), ellipses (…), or any non-ASCII punctuation — TTS engines vocalize them as gibberish. Use commas, periods, or rewrite the sentence.
- **Pronounce "AGNT" as "Agent"** — write "Agent Space" in narration text, never "AgntSpace" (which TTS reads letter-by-letter).
- **Pronounce "AI" as "A.I."** — write "A.I." with periods.
- **Cap at 12 scenes.** More than 12 scenes in a 60-second video means each scene is under 5 seconds — too short to absorb. Cut.
- **Cap at 180 seconds total.** Anything longer needs a different format (a tutorial document, a presentation), not a video.
- **One question max if ambiguous.** "Did you mean the Volvo-Northvolt wiki page or the Volvo KB?" — pick the more likely interpretation, ask only if the wrong choice would waste real time.
- **Style default is `walkthrough`.** Don't pick `promo` unless the user said "promo" / "marketing" / "trailer". Don't pick `tutorial` unless they said "how do I" / "tutorial" / "explain how to".
- **Surface warnings honestly.** If `create_video` returns degraded modes (offline TTS, missing browser), tell the user — don't paper over the difference.

## Examples

- input: "Make a 60-second video about my Volvo-Northvolt wiki page"
  output: |
    [calls search_vault to confirm slug → "volvo-northvolt"]
    [drafts 6-scene outline: intro → context → battery factory → BMW deal → market signal → outro]
    [calls create_video(target="wiki:volvo-northvolt", duration_seconds=60, voice="liam", style="walkthrough")]
    Done. agntspace-projects/personal/output/videos/volvo-northvolt-2026-04-24-1530.mp4 (62 seconds, 6 scenes, 145 words narrated).

- input: "Make a quick promo video about my AI knowledge base"
  output: |
    [calls search_vault → "ai" KB exists]
    [drafts 8-scene outline: hero → 3 featured articles → graph view → takeaway]
    [calls create_video(target="kb:ai", duration_seconds=60, voice="liam", style="promo")]
    Done. agntspace-projects/personal/output/videos/kb-ai-2026-04-24-1535.mp4 (58 seconds, promo style, 8 scenes).

- input: "Record a walkthrough of project Phoenix"
  output: |
    [calls search_vault → confirms project slug]
    [drafts 7-scene outline: title → goals → recent progress → tasks → next steps]
    [calls create_video(target="project:phoenix", duration_seconds=60, voice="liam", style="walkthrough")]
    Done. agntspace-projects/phoenix/output/videos/phoenix-walkthrough-2026-04-24-1540.mp4 (64 seconds, 7 scenes).

- input: "Narrate https://example.com/article in a 30-second video"
  output: |
    [drafts 3-scene outline based on URL preview]
    [calls create_video(target="url:https://example.com/article", duration_seconds=30, voice="liam", style="walkthrough")]
    Done. agntspace-projects/personal/output/videos/example-com-article-2026-04-24-1545.mp4 (32 seconds, 3 scenes).