Doc Real
Documentary realism: letterboxed frame, film grade, small lowercase subtitles and a location tag.
- Best for: mini-documentaries, founder stories, travel, interviews, brand films
- Category: Talking-head reel
- Default format: 9:16 (change with
--format 9:16 | 1:1 | 4:5 | 16:9) - Needs camera footage: yes, a raw talking clip
- Text behind the speaker: no
Before you start
This style runs on the video-studio-core skill, which must be installed in the same skills folder.
CORE= thevideo-studio-corefolder next to this one (e.g.~/.claude/skills/video-studio-core).STYLE= this skill's folder (it holdstheme.jsonandtheme.css).- First time on a machine:
python CORE/scripts/check_env.py, and fix anything it reports. - If
COREis missing, tell the user to installvideo-studio-corefrom the same pack.
Make the edit
python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "place, time"
# refine edit-*/plan.json (see below), then check stills:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json
Open contact_sheet.png and look at it before the full render. The final video is final.mp4 in the work folder.
Use --formats 1:1,16:9 on finish.py for extra sizes. Add music with "music": {"src": "track.mp3", "volume": 0.12} in the plan.
The look
- Letterbox bars, film grade, grain, slow push. Subtitles small, lowercase, white, centred low.
- A small location or chapter tag top-left in the first 3 s. No zooms, no emoji, no sfx.
Refine the plan
The draft from make_plan.py is automatic. Make it good:
- Read
words.jsonand rewrite the hook (first 2-3 s) into a short, specific promise. - Replace weak auto-picked key words with the words that carry the meaning (numbers, results, names, contrasts).
- Fix any mis-heard words in the
wordsarray (keep their times). - Pass a location/context as
--title(e.g. 'julana, haryana — 6:40 am'). - Add
titlecardchapter breaks with classdr-chapterfor longer films. - Element types and fields:
CORE/references/plan-schema.md.
Check before delivering
- Contact sheet: text readable, nothing cut off, nothing covering the face unless intended, safe zones respected (9:16: keep text between 10% and 85% of the height).
- Watch for timing: overlays land with the spoken word, not after it.
ffprobethe final file: right size, duration and audio.- Tell the user what you cut (seconds removed), what the look adds, and where the file is.
Change the look
Colours and fonts live in theme.json (vars, fontsUrl) and theme.css. For a one-off change, edit plan.json (theme.vars, element style) instead of the skill files.
Example requests
- "Documentary-style edit."
- "Make my story feel like a Netflix doc."
- "Cinematic doc look with a location tag."