v1.0.12 to v1.0.12

---

name: video-editing

description: Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.

license: MIT

metadata:

version: "1.0.12"

package: pruna-skills

---

# Video editing

Vendor-neutral craft for **local post-production** on finished media. Works with any clips, stills, VO, or beds you already have — from any source.

**This skill is not generative video editing.** It does not write motion prompts or call video generation APIs. Produce or collect media first; assemble and polish here.

## Install

| Skill | Description | Install |

| --- | --- | --- |

| `video-editing` | Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits. | `npx skills add PrunaAI/pruna-skills@video-editing -y` |

## When to use

- Stitch multiple rendered clips (hard cut or crossfade)

- Burn in **phrase captions** — word-accent promo, **simple phrase** (landscape explainers), or line-block — see [captions.md](./references/captions.md)

- Add title cards, lower-thirds, or logo watermarks

- Build before/after or side-by-side comparison clips

- Mix an instrumental bed under dialogue or VO (~10–20% under speech for explainers; taste varies)

- Export for social aspect ratios (9:16, 1:1, 16:9) with loudness normalization

- Compose a **multi-act narrated showcase** (hook, context, reel, close) via HyperFrames or ffmpeg — [narrated-showcase.md](./references/narrated-showcase.md)

- Compose a **combination video** with UI chrome, chat mocks, or multi-panel layouts via [Hyperframes](https://github.com/heygen-com/hyperframes) (optional — see [combination-hyperframes.md](./references/combination-hyperframes.md))

## Works with

Any finished MP4/MOV/WebM plus local **ffmpeg** / **ffprobe**. Caption alignment often uses Replicate **whisperx** (or any timed transcript you already have). Beds and VO may come from any TTS or music tool. Upload helpers in sibling skills are optional, not required.

## When NOT to use

Use a different skill instead:

| Skill | Description | Install |

| --- | --- | --- |

| `video-prompting` | Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining. | `npx skills add PrunaAI/pruna-skills@video-prompting -y` |

| `p-video-avatar` | Use when someone wants a person on camera speaking a script — lip-synced host, spokesperson, or narrated avatar from a portrait photo. | `npx skills add PrunaAI/pruna-skills@p-video-avatar -y` |

| `p-video-animate` | Use when someone wants a photo to move like another video — motion transfer, dance remixes, or performance variations from a template clip. | `npx skills add PrunaAI/pruna-skills@p-video-animate -y` |

| `p-video-replace` | Use when someone wants to swap a person, outfit, or product inside existing footage while keeping the camera move and audio. | `npx skills add PrunaAI/pruna-skills@p-video-replace -y` |

| `p-image-edit` | Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits. | `npx skills add PrunaAI/pruna-skills@p-image-edit -y` |

| `music-video` | Use when someone wants a full music video — original song or vocals, performance clips, B-roll, and lyric-synced edits. | `npx skills add PrunaAI/pruna-skills@music-video -y` |

| `narrated-multi-scene` | Use when someone wants a multi-part story with voiceover — episodic B-roll, chaptered promo, or several linked video scenes without on-camera dialogue. | `npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y` |

## Guide habit

In the **first reply**, name `` `video-editing` `` in backticks. Confirm inputs exist on disk (clips, optional bed, optional logo). Confirm **`ffmpeg`** / **`ffprobe`** are available. When source media, palette, audio, captions, aspect, resolution, or act structure are open, open intake → **`generation-diversity`** clarification intake before generating missing pieces or starting a long render. Only call generative or alignment APIs when the user explicitly needs a missing bed, TTS, or caption timing (e.g. `whisperx`).

## Structure and creativity (multi-act pieces)

When the brief is “explain and show” with VO plus existing clips or stills:

1. **Propose structure before pixels** — offer two or three act orders (e.g. explain-then-show vs show-then-explain). See flow presets in [narrated-showcase.md](./references/narrated-showcase.md); merge, drop, or rename acts freely.

2. **Separate beats visually** — a text-heavy “how it works” act should not look like the proof reel (different layout, no duplicate preview grid unless the brief asks for it).

3. **Run the reel through narration** — extend the showcase window until VO finishes; rotate one hero frame or cycle clips with crossfades when clip count is low and size matters.

4. **Captions after render** — burn on the finished MP4; pick style for readability (karaoke vs simple phrase). See [captions.md](./references/captions.md).

5. **Borrow patterns, don’t clone** — tokens, motion habits, and act *types* from a reference reel; don’t reuse another project’s scene order if the message differs. [motion-composition-craft.md](./references/motion-composition-craft.md).

If the user already named a layout, implement it; still confirm pacing and caption style after the first preview or render when the brief was vague.

## Before assembling

Read in order for the task at hand:

1. [assembly-concat.md](./references/assembly-concat.md) — concat, normalize, mux

2. [transitions.md](./references/transitions.md) — `xfade` / `acrossfade`

3. [captions.md](./references/captions.md) — `whisperx` → phrase-bar + word-accent (default) or simple phrase / line-block → burn-in

4. [overlays.md](./references/overlays.md) — `drawtext`, logo watermark

5. [comparison-sliders.md](./references/comparison-sliders.md) — side-by-side / before-after

6. [background-music.md](./references/background-music.md) — bed under VO

7. [motion-composition-craft.md](./references/motion-composition-craft.md) — example visual tokens, open act patterns, instructional beats, motion habits

8. [narrated-showcase.md](./references/narrated-showcase.md) — flow presets, reel timing, hero vs grid

9. [combination-hyperframes.md](./references/combination-hyperframes.md) — HTML combo videos (optional)

10. [social-usecase-reel.md](./references/social-usecase-reel.md) — portrait workflow demo structure; example visuals are suggestions

11. [export-presets.md](./references/export-presets.md) — aspect ratios, loudnorm, web export

Bed **prompts** and embed-vs-post policy: `audio-prompting`.

## Combination videos (Hyperframes)

When the deliverable needs **designed frames** — chat UI mocks, kinetic type, multi-panel grids, montages with on-screen copy — install **`hyperframes`** (optional external — see [Related skills](#optional-hyperframes) below) and follow [combination-hyperframes.md](./references/combination-hyperframes.md).

**Pattern:** HyperFrames render (motion + VO, no burned captions) → post-render ffmpeg (whisperx → caption burn — style per [captions.md](./references/captions.md) → optional bed mux → export). Multi-act structure: [narrated-showcase.md](./references/narrated-showcase.md) + [motion-composition-craft.md](./references/motion-composition-craft.md). Portrait **workflow demo** reels: suggested act order and HyperFrames timing in [social-usecase-reel.md](./references/social-usecase-reel.md). Colors, type, and bar layout there are **example proposals**, not required tokens.

## Related skills

Install related skills when the job needs them:

| Skill | Description | Install |

| --- | --- | --- |

| `generation-diversity` | Use when writing any generative prompt — ritual seed, explicit structure, scenario axes, and quality gates before paid API calls. | `npx skills add PrunaAI/pruna-skills@generation-diversity -y` |

| `whisperx` | Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing. | `npx skills add PrunaAI/pruna-skills@whisperx -y` |

| `stable-audio-2.5` | Use when someone wants light instrumental background music — an ambient bed under dialogue or underscore for reels and explainers. | `npx skills add PrunaAI/pruna-skills@stable-audio-2.5 -y` |

| `gemini-3.1-flash-tts` | Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video. | `npx skills add PrunaAI/pruna-skills@gemini-3.1-flash-tts -y` |

| `audio-prompting` | Use when crafting TTS, music, or bed prompts for any generative audio model — director style, song structure, and post-production layering. | `npx skills add PrunaAI/pruna-skills@audio-prompting -y` |

| `pruna-api` | Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety. | `npx skills add PrunaAI/pruna-skills@pruna-api -y` |

Or install the full suite once: `npx skills add PrunaAI/pruna-skills@pruna -y`