Course Video Studio

---
name: "course-video-studio"
description: "Turn lesson materials into presenter-led course videos with lecture narration. This course video studio prepares the spoken narration for each lesson, then records a digital-teacher delivery, so enablement teams get ready-to-publish lecture videos and training presenter clips."
---

# Course Video Studio

Turn finished lecture scripts and one authorized teacher portrait into
lesson videos. Each lesson is narration first, then talking-head clips
that fully contain the speech.

## Scope and adjacent routes

Use this Skill when a course or training team wants talking-head lesson
videos from a stable portrait plus lecture text.

Route audio-only course work to `course-narration-studio`. Route a single
presenter clip to `talking-avatar-video`. Route a founder weekly update to
`founder-ip-avatar-studio`. Without authorization for the likeness and the
voice, stop at confirmation.

## Inputs and defaults

The hard inputs are:

- one accessible teacher portrait;
- final lecture text for at least the pilot lesson;
- lesson order;
- likeness and voice rights;
- a pronunciation table whenever the lecture contains recurring names,
  terms, or acronyms.

If those terms exist and the table is empty, stop and collect the readings.
Do not guess them. Final lecture text is the spoken source. A deck is
useful only after the user extracts the spoken script; this Skill does not
parse slides.

Reuse the frozen `voice_id`, language, and framing. Default to
`model: "auto"` for video and a source-derived aspect ratio. Split a
lesson into sequential containable clips when planned speech is longer
than the longest video duration that can hold it.

## Golden path

1. Inspect the portrait. Record MIME type, width, height, aspect ratio, byte
   size, and whether it has an alpha channel. Build the lesson ledger. For a
   local portrait or sample, upload only through the bundled client after
   inspection. Never pass a local path to a remote tool.
2. Select or clone a teacher voice. A clone requires consent first;
   access to a file is not consent. A suitable sample is currently about
   10 to 300 seconds, no larger than 20 MiB, and clean single-speaker
   speech. Use the live `voice_clone` admission card before any clone
   `client_request_id` or `beatra.voices.clone` call: route
   `voice_clone`, tool `beatra.voices.clone`, live price for one
   successful activated voice, the provisional estimate, the 600-credit
   signup gift usually cannot start this clone, and what happens if the
   balance is short. Do not create `client_request_id` or submit until
   the user confirms they have topped up or already have enough credits.
   Do not offer a free clone. Submit `beatra.voices.clone` exactly once:

   ```json
   {
     "sample": {"type": "artifact", "artifact_id": "artifact_..."},
     "display_name": "Course Teacher",
     "consent_attested": true,
     "model": "auto",
     "client_request_id": "opaque-course-video-clone"
   }
   ```

   Poll with `beatra.tasks.get` until terminal, then freeze the returned
   `voice_id`. Without a clone, call
   `beatra.voices.list` when a catalog voice still needs to be selected.
   Never put a display name in `voice`.
3. Call `beatra.models.list` for `text_to_speech` and `image_to_video`.
   Confirm the video route admits `[image, driving_audio]`. Compare the
   portrait's actual MIME, dimensions, byte size, and alpha-channel
   presence with every advertised image constraint. Read the longest
   video duration that can fully contain speech. Split the pilot lecture
   into sequential containable segments at sentence or section
   boundaries. Do not shorten the lecture to cheapen a clip. Do not ship
   a truncated lesson. Use `mp3` only
   when the live speech card supports it and the live video card accepts
   `audio/mpeg`. If the user requested `flac`, `opus`, or `pcm` and the
   video route does not accept the resulting format, explain the
   incompatibility before any paid call and obtain the user's choice. Do
   not silently change the format. If any required media fact is
   unavailable or incompatible, stop before TTS. Keep each speech
   `input` at or below 50,000 characters.
4. Confirm the pilot speech card: script segments, voice, format, live
   estimate, and one `client_request_id` per `beatra.speech.synthesize`
   call. Submit each segment once through the bundled client. Poll each
   narration task with `beatra.tasks.get` until terminal. Read the
   returned artifact plus actual `task.output.audio.mime_type`,
   `duration_seconds`, and `size_bytes`. Approve the real audio before
   that segment's video. Never treat a script preview as an audio review.
5. Refresh the `image_to_video` cards and admit the actual portrait plus
   that segment's approved speech. Recheck every image and driving-audio
   fact. If terminal audio size remains unavailable, stop before video.
   Use the smallest supported integer video duration at or above the
   actual speech length. Show the video admission card before
   `beatra.videos.animate`: route `image_to_video`, tool
   `beatra.videos.animate`, approved portrait and speech artifacts,
   prompt, audio-led duration, resolution if set, output count,
   provisional live estimate, the 600-credit gift usually cannot start
   this video, and what happens if the balance is short. Do not submit
   until the user confirms they have topped up or already have enough
   credits. Approved narration does not authorize the video call. Each
   segment video has its own `client_request_id`.
6. After the pilot lesson's clips are accepted, repeat
   segment-narration-then-video for remaining lessons. Each paid stage
   has its own `client_request_id`. Submit only through the bundled
   `scripts/mcp_client.py`. Do not configure a host Beatra Connector. Do not use REST/OpenAPI as a fallback. Poll every video task with
   `beatra.tasks.get` until terminal.
7. Deliver labeled lesson videos in teaching order, with segment order
   inside a lesson, plus actual dimensions, duration, usage, and
   `billing.net_charged_credits`. Review identity, term readings, and
   lip timing.

## Decisions that require confirmation

Confirm rights, the voice, the pilot, and every video admission card. A
changed lecture is new narration and, if the audio changes, a new video.

## Recovery

Recover each stage only with its identical frozen payload and ID. Recover
a lost task ID through `beatra.tasks.list` and `beatra.tasks.get`. On
`insufficient_balance`, keep the top-up URL inside the balance error
exact and retry the same frozen `client_request_id` only after the user
says they have topped up.

## Account balance

When the user asks how many credits remain or whether a live estimate fits,
call `beatra.wallet.get`. When they ask what was charged, call
`beatra.wallet.ledger`. Both are read-only. Do not invent an account-balance or
top-up tool. Do not make `wallet.get` a required step before every paid submit.

When a model card comes back carrying a `top_up` block, relay its tiers as the
card lists them and in that order. Do not rank them, do not talk one down, and
do not pick one for the user. Which tier suits them is their call, made on
the wallet page with the whole list in front of them. Never quote a tier from
memory.

## References by task

- Read [Course video workflow](references/workflow.md) for ledgers,
  admission cards, payloads, and review.
- Read [Installation and authentication](references/installation-and-auth.md)
  only when authorization needs attention.
- Read [Installation registration](references/installation-registration.md)
  for first-use registration.
- Read [Tasks and results](references/tasks-and-results.md) and
  [Billing, errors, and recovery](references/billing-errors-and-recovery.md)
  for task and billing facts.
- Read [Bundled MCP Client diagnostics](references/mcp-connection.md) when
  the bundled client cannot connect.
- Read [Automatic updates and safety](references/automatic-updates-and-safety.md)
  for update controls.
- Read [Uninstall and disconnect](references/uninstall-and-disconnect.md)
  only when the user asks to remove the package.

## Runtime and safe automatic updates

Use or invoke the bundled `scripts/mcp_client.py` for every Beatra operation.
Before ordinary commands it silently checks for a newer release at most once
every 24 hours per installation. Silent checks are enabled by default, and a
newer release installs without separate confirmation.

The updater accepts only the fixed official discovery address and immutable
Beatra CDN path embedded for this package, channel, and locale. It verifies
the discovery data, archive, manifest, and every file's size and checksum
before replacement. It replaces only package-owned files and rejects
redirects, downgrades, wrong package/channel/locale/version data, unexpected
URLs, unsafe archives, and files outside the owned destination.

Update checks, downloads, verification, replacement, rollback, and recovery
fail open: the current installation remains usable and the user's original
command continues. An update failure never authorizes retrying a paid
generation. The automatic-update choice persists across later commands for
this installation:

```text
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
```