Skip to content
Back to search

cutvideo

SkillWorks with Claude CodeGitHub

Claude Code skill: edit raw footage into finished videos (cuts, montage, subtitles, effects)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fujiezee--cutvideo/badge.svg)](/listings/fujiezee--cutvideo)

HTML

<a href="/listings/fujiezee--cutvideo"><img src="/api/listings/fujiezee--cutvideo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use it in this repository, or copy the skill into another project or into your user skills:

cp -r .claude/skills/video-edit <your-project>/.claude/skills/   # one project
cp -r .claude/skills/video-edit ~/.claude/skills/                # all projects

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 112 lines
  1. # cutvideo
  2. A [Claude Code](https://claude.com/claude-code) skill that turns raw footage into a finished
  3. video. You hand Claude the video files; it watches them (contact sheets + transcript), plans
  4. the cut, renders it with ffmpeg, reviews its own render, and iterates.
  5. It handles talking-head jump cuts, vlogs, highlight montages, beat-synced shorts (9:16),
  6. trailers, cast intros, and product or event recaps, with subtitles, transitions, effects,
  7. colour grading, titles and background music.
  8. ## Gallery
  9. Eight edits of the open movie *Tears of Steel*, one style each, all made by Claude with this
  10. skill from the film alone. Click a thumbnail to download the video; the edit plans and build
  11. scripts are in [`examples/tears-of-steel/`](examples/tears-of-steel/).
  12. <table>
  13. <tr><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_trailer_16x9.mp4"><img src="examples/tears-of-steel/gallery/tos_trailer_16x9.jpg" width="260" alt="Trailer"></a><br><b>Trailer</b><br><sub>16:9 · 1:11</sub></td><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_cast_16x9.mp4"><img src="examples/tears-of-steel/gallery/tos_cast_16x9.jpg" width="260" alt="Cast intros"></a><br><b>Cast intros</b><br><sub>16:9 · 0:35</sub></td><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_cyberpunk_16x9.mp4"><img src="examples/tears-of-steel/gallery/tos_cyberpunk_16x9.jpg" width="260" alt="Cyberpunk glitch"></a><br><b>Cyberpunk glitch</b><br><sub>16:9 · 0:41</sub></td></tr>
  14. <tr><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_vhs_4x3.mp4"><img src="examples/tears-of-steel/gallery/tos_vhs_4x3.jpg" width="260" alt="Retro VHS"></a><br><b>Retro VHS</b><br><sub>4:3 · 0:39</sub></td><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_silent_4x3.mp4"><img src="examples/tears-of-steel/gallery/tos_silent_4x3.jpg" width="260" alt="Silent film"></a><br><b>Silent film</b><br><sub>4:3 · 0:46</sub></td></tr>
  15. <tr><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_trailer_9x16.mp4"><img src="examples/tears-of-steel/gallery/tos_trailer_9x16.jpg" width="150" alt="Trailer, vertical"></a><br><b>Trailer, vertical</b><br><sub>9:16 · 1:11</sub></td><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_karaoke_9x16.mp4"><img src="examples/tears-of-steel/gallery/tos_karaoke_9x16.jpg" width="150" alt="Word-highlight captions"></a><br><b>Word-highlight captions</b><br><sub>9:16 · 0:26</sub></td><td align="center"><a href="https://github.com/fujiezee/cutvideo/releases/download/showcase-v1/tos_beatmix_9x16.mp4"><img src="examples/tears-of-steel/gallery/tos_beatmix_9x16.jpg" width="150" alt="Beat-sync mix"></a><br><b>Beat-sync mix</b><br><sub>9:16 · 0:20</sub></td></tr>
  16. </table>
  17. <sub>*Tears of Steel* © Blender Foundation · [mango.blender.org](https://mango.blender.org) ·
  18. [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/)</sub>
  19. ## Requirements
  20. - `ffmpeg` / `ffprobe`
  21. - Python 3.10+ with `numpy`, `opencv-python`, `Pillow`
  22. - `faster-whisper` for transcripts and subtitles (the model downloads on first use)
  23. - Optional: `rembg` for cleaner person cut-outs in character intros (OpenCV GrabCut is used
  24. otherwise)
  25. ```bash
  26. pip3 install --user numpy opencv-python Pillow faster-whisper
  27. ```
  28. ## Install
  29. Use it in this repository, or copy the skill into another project or into your user skills:
  30. ```bash
  31. cp -r .claude/skills/video-edit <your-project>/.claude/skills/ # one project
  32. cp -r .claude/skills/video-edit ~/.claude/skills/ # all projects
  33. ```
  34. ## Usage
  35. Open Claude Code in the project and give it footage:
  36. ```text
  37. Edit trip/*.mp4 into a 30-second vertical highlight reel with music.mp3, beat-synced
  38. ```
  39. Claude creates a job folder under `edits/<job>/`, then produces the video, an `.srt` when
  40. there is speech, and the `edl.json` it rendered from. To make changes later, ask Claude: it
  41. edits `edl.json` and renders again.
  42. ## How it works
  43. | Step | Script | Output |
  44. |---|---|---|
  45. | Analyze | `scripts/analyze.py` | shot list with motion, sharpness, colour and loudness scores; silences; transcript with word timings; music BPM, beats and drops; labelled contact sheets |
  46. | Draft (optional) | `scripts/draft_edl.py` | a first-pass EDL: `jumpcut` (speech only) or `montage` (best shots, beat-synced) |
  47. | Render | `scripts/render.py` | the video: trim, speed, reframe, effects, grade, transitions, text and subtitle layer, music ducking, -14 LUFS loudness |
  48. | Review | `scripts/preview.py` | frame sheets of the output for checking framing, text and pacing |
  49. The scripts also run on their own:
  50. ```bash
  51. S=.claude/skills/video-edit/scripts
  52. python3 $S/analyze.py in.mp4 --out edits/demo/work --music song.mp3
  53. python3 $S/draft_edl.py edits/demo/work/analysis.json --mode montage --format 9:16 --music song.mp3 --out edits/demo/edl.json
  54. python3 $S/render.py edits/demo/edl.json --draft # half resolution, fast
  55. python3 $S/render.py edits/demo/edl.json # final
  56. ```
  57. ## Features
  58. - **Transitions:** about 40 xfade types (fade, dissolve, slides, wipes, circle, zoom, whip, ...)
  59. - **Effects:** Ken Burns zoom, punch-in, shake, flash, glitch, freeze frame, reverse, speed
  60. change, black and white, blur, grain, vignette, ghost trails
  61. - **Grades:** natural, vivid, cinematic, teal_orange, warm, cool, moody, vintage, film, bw,
  62. fade, bright, trailer, vhs, silent, cyberpunk, or a `.cube` LUT; per-shot colour matching
  63. - **Text:** title, caption, highlight, lower third, label, tag, quote; fade, pop, slide and
  64. typewriter animations; per-word colour highlights; CJK fonts
  65. - **Subtitles:** built from the transcript and kept in sync across cuts and speed changes;
  66. word-by-word (karaoke) highlighting; bilingual lines; exported as `.srt`
  67. - **Character intros:** freeze frame, person cut out in colour, name and role panel slide in
  68. - **Audio:** music beds with ducking under dialogue, J/L cuts, synthesised trailer SFX
  69. (boom, hit, whoosh, riser, ...), beat sync, cuts pinned to music hits, loudness and
  70. true-peak control
  71. - **Planning:** a written edit plan (structure, music map, look, text) before any render
  72. - **Framing:** face-tracking crops that pan with the subject, static face-centred or manual
  73. focus, blurred background fill, or letterbox; one edit exported to 16:9 / 9:16 / 1:1 / 4:5
  74. - **Self-check:** after rendering, the output is re-transcribed to confirm every caption is
  75. still intelligible in the mix, plus loudness, true-peak and silence checks
  76. - **Looks:** scan lines, projector flicker, intertitle cards, neon and camcorder-stamp text
  77. - **3D and effects:** extruded 3D titles with perspective animation, text placed behind
  78. people (per-frame cut-outs), three.js light effects (particles, holograms, light streaks,
  79. neon grid) composited like a screen blend
  80. - **Style menu:** scores what a film can be cut into (trailer, cast intros, silent film,
  81. cyberpunk, ...) with the shots that support each style
  82. Text is drawn with Pillow, so ffmpeg builds without `drawtext` or `libass` work.
  83. ## Docs
  84. - [`SKILL.md`](.claude/skills/video-edit/SKILL.md): the workflow Claude follows
  85. - [`reference/edl.md`](.claude/skills/video-edit/reference/edl.md): EDL format
  86. - [`reference/editing-playbook.md`](.claude/skills/video-edit/reference/editing-playbook.md):
  87. editing recipes by video type

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.