| name | videographer |
| description | Directed capture and narrative export — compose keyframe stories, record video (WebM/MP4), capture hi-res snapshots from the 3D substrate.
CENTROID:
directed capture and narrative export surface for the 3D substrate
IS:
- keyframe story composition with camera, overlay, and duration capture
- video recording in WebM (VP9) or MP4 (H.264) at 1080p / 2K / 4K
- hi-res and screen-resolution still snapshots
- prep-mode playback with overlay cross-fade
IS NOT:
collapse_zones:
- scene mutator (captures substrate state; never modifies the scene graph)
- governance emitter (narrative capture only; no signal, tic, or warrant writes)
- asset publisher (records locally; distribution belongs to downstream pipelines)
- runtime scene editor (prep-mode captures configuration; never reshapes the live scene)
- editorial deliverable pipeline (substrate capture is distinct from any future media-egress pipeline; current scope is substrate-only)
sibling_overlaps:
- /statusline (both are observation surfaces — statusline reads conformation text, videographer captures scene video)
- fal_router.py / overshoot_router.py (vendor-trajectory media lanes — distinct asset lineage; videographer captures from substrate, routers dispatch to/from external vendors)
WHEN:
- when a substrate scene is composed and narrative export is needed
- when demoing or narrating a substrate tour
- when a publication-quality snapshot of substrate state is required
NOT WHEN:
- without a loaded substrate scene (nothing to capture)
- as a signal-emission or governance-mutation surface
- for non-substrate content (external editorial video flows through the vendor-trajectory media routers, not videographer)
RELATES TO:
- /statusline (both observe — statusline is textual ambient; videographer is visual capture)
- fal_router.py / overshoot_router.py (vendor-trajectory media routing — videographer serves substrate; routers serve external vendor capability surface)
ARGS:
stance: dispatch
off_envelope: proceed-with-note
# off_envelope rationale: /videographer's established default is "capture the
# current scene" with no args. Undeclared-arg most commonly means "apply default
# capture" rather than caller confusion — proceed-with-note preserves flow.
core_dispatch_rays:
- "" → prep-mode capture (compose + preview current scene)
- "record" → begin video recording at configured resolution
- "snapshot" → hi-res still at selected resolution
secondary_modulation_axes:
- format: webm | mp4
- resolution: 1080p | 2K | 4K
- overlays: on | off
|
| user-invocable | true |
/videographer
Directed capture skill for the Anchorage of Ubiquity 3D substrate. Use this to compose camera stories, record presentation videos, and capture publication-quality snapshots.
Quick Reference
| Action | How |
|---|
| Enter prep mode | Press A until "Presentation Prep" banner appears |
| Add keyframe | Press K (captures camera + overlay state) |
| Play/stop | Press Space |
| Record | Press R or click Rec button |
| Hi-res snapshot | Click download icon in PREP panel header |
| Toggle shortcuts help | Press ? |
Workflow
1. Compose
Position your camera, then press K to add keyframes. Each keyframe captures:
- Camera position, target, and field of view
- Current overlay state (selected entity, viz mode, visible layers)
- A thumbnail plate for the shot card
Adjust duration and easing per shot in the shot cards. Duration = transit time to the next keyframe, not hold time.
2. Preview
Press Space to play the story. Camera interpolates continuously between keyframes. Overlays cross-fade at segment boundaries when consecutive shots have different overlay states.
3. Configure Export
In the EXPORT section of the PREP panel:
- Format: WebM (VP9, universal) or MP4 (H.264, Chrome/Edge only)
- Recording resolution: 1080p / 2K / 4K (renderer upscales during recording)
- Mode: "Export only" (download video) or "Export + archive" (persist story)
- Playback overlays: toggle which overlays appear during recording
4. Record
Press R to start recording. The renderer resizes to your selected resolution, playback begins, and the video auto-downloads when complete.
5. Snapshots
For still images, use the header buttons:
- Download icon = hi-res snapshot at selected resolution
- Image icon = screen-resolution plate capture
Tips
- Hold shots: Set two consecutive keyframes at the same position — the camera holds static for that duration
