chengfeng-export

Renders edited narration cuts, subtitles, and HTML overlay layers into a final mp4 video.

3.0k|383|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-export
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chengfeng-export
Source: https://github.com/Agentchengfeng/chengfeng-videocut-skills/tree/main/plugins/chengfeng-videocut/skills/chengfeng-export
Command: npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills --skill chengfeng-export

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a fully annotated video project—edit ledger, subtitles, and HTML visual layers—into a single finished mp4 file, replacing manual timeline rendering and frame-by-frame verification.

Core Features & Use Cases

  • Two-step export: Run a dry-run plan first to report duration, frame counts, subtitle screens, and overlay layers, then execute the real assemble → overlay → compose → verify pipeline.
  • Resolution guidance: Inspect source resolution and choose scale 1 for native Retina footage or scale 2 for low-resolution sources, since subtitles and animations are redrawn at output size.
  • Source replacement workflow: Swap in a higher-quality recording of the same session by verifying identical duration and audio hash, then updating source fingerprints in project files.
  • Acceptance checks: Extract frames from the rendered mp4 with ffmpeg to visually verify zoom segments, animations, and subtitle-only sections.
  • Use Case: After finishing word-level cuts, subtitles, and visual layers for a talking-head screen recording, run the export to burn everything into a deliverable mp4 and confirm the pixels match the plan.

Quick Start

Use the chengfeng-export skill to export this project into a final mp4: run the dry-run plan first, then render, then extract frames from the output for visual acceptance.

Frequently Asked Questions about chengfeng-export

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export an edited video project to mp4 with subtitles?

Run the export CLI with --dry-run first to review the plan (duration, frames, subtitle screens, overlay layers), then run the real export which executes assemble, overlay, compose, and verify stages. The output is a single mp4 with everything burned in.

How do I improve the resolution of an exported screen recording?

Check the source width in the dry-run output first. If the source is at least 2560px wide, use --scale 1 for native pixels; for low-resolution sources, ask for a higher-resolution re-export of the same recording, or fall back to --scale 2 since subtitles and animations are redrawn at output size.

Why does video export fail when Chrome is not installed?

The export pipeline requires Google Chrome to render subtitle and animation layers into images. Without Chrome there is no subtitle or animation layer, so the command reports an explicit error rather than bypassing the requirement.

Can I replace the source video with a higher quality recording?

Yes, if the new file has identical duration and bit-identical audio, meaning the timeline is unchanged. Replace the hard-linked source files, update the source SHA-256 fingerprint in project.json and workbench.json, then re-export with --scale 1.

Why is my exported mp4 missing subtitles or animations?

Use --keep-work to inspect intermediate outputs: check whether overlay PNGs are fully transparent, whether the HTML module responds to seek, and whether the module declares a dark color-scheme. Missing layers usually trace back to module implementation issues, not the export step.