Skip to content
Back to search

video-edit

SkillWorks with Claude CodeGitHub

"Turns raw 9:16 talking-head clips into a finished, premium Instagram reel end to end: picks the cleanest take of every line across your clips, cuts dead air, punches in from 4K, cuts you out of the background for words behind your head, applies one of three designed looks (bold kinetic words, cool girl, cool dude), builds animated UI inserts with parallel sub-agents, adds subtle sound design, and checks every cut frame by frame inside the Reels safe zone. Trigger with /video-edit or phrases like 'edit these clips', 'I dropped clips in my downloads', 'cut this into a reel', 'make this reel look fire'."

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tenfoldmarc--video-edit-skill/badge.svg)](/listings/tenfoldmarc--video-edit-skill)

HTML

<a href="/listings/tenfoldmarc--video-edit-skill"><img src="/api/listings/tenfoldmarc--video-edit-skill/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.

No terminal needed.

Step 1: Open Claude Code

Open Claude Code: the Code tab in the Claude desktop app, or type `claude` in your terminal. (This skill renders video on your computer, so it needs Claude Code; a regular chat can't run it.)

Step 2: Paste this message

Copy-paste this into the chat and hit Enter:

Install this skill for me: https://github.com/tenfoldmarc/video-edit-skill

Claude downloads the skill into your skills folder and tells you when it's ready. Takes a few seconds.

Step 3: Run the skill

Type:

/video-edit

Hit Enter. On your first run, the skill asks your name, your Instagram handle and your favorite look, checks your tools and sets up everything it needs (about 2 minutes, once). Just follow the prompts.

<details> <summary>Prefer the terminal? Manual install</summary>

Open Terminal (Mac: `Command + Space`, type Terminal. Windows: Start menu, type PowerShell). Paste this one line and hit Enter (it needs [git](https://git-scm.com/downloads) installed):

git clone https://github.com/tenfoldmarc/video-edit-skill "$HOME/.claude/skills/video-edit"

Then type `claude` to open Claude Code and run `/video-edit`. </details>

---

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.

SKILL.md · Manifest · 169 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: video-edit
  3. description: "Turns raw 9:16 talking-head clips into a finished, premium Instagram reel end to end: picks the cleanest take of every line across your clips, cuts dead air, punches in from 4K, cuts you out of the background for words behind your head, applies one of three designed looks (bold kinetic words, cool girl, cool dude), builds animated UI inserts with parallel sub-agents, adds subtle sound design, and checks every cut frame by frame inside the Reels safe zone. Trigger with /video-edit or phrases like 'edit these clips', 'I dropped clips in my downloads', 'cut this into a reel', 'make this reel look fire'."
  4. ---
  5. # /video-edit
  6. Raw clips in, finished reel out. The user never opens an editor: they review a phone copy and give notes; every
  7. round is a ~2 minute re-render.
  8. Read before building: `references/looks.md` (the three looks, exact values), `references/layout.md` (safe zone,
  9. placement, behind-head formula), `references/gotchas.md` (every trap already hit once). Read
  10. `references/overlays.md` when the script calls for an animated insert.
  11. Works on macOS, Linux and Windows. setup.py detects the machine at the start of every run and every command below
  12. comes from that record, so never guess paths or shells: see "This machine" right after Step 0.
  13. ## Step 0: First-time setup (runs once)
  14. `SK` is this skill's folder (the one holding this SKILL.md), as a full path. Usually `~/.claude/skills/video-edit`;
  15. on Windows that is `C:/Users/<name>/.claude/skills/video-edit`.
  16. Look for `SK/config.json`.
  17. **If it exists:** load it (name, instagram handle, default look, folders), run the setup script exactly as in
  18. step 3 below (a few seconds: it only checks, and repairs the environment after an update), read "This machine",
  19. and go to Step 1 once it prints READY.
  20. **If it does not exist:**
  21. 1. Say: "Welcome to /video-edit! Let's get you set up. This takes about 2 minutes and only happens once."
  22. 2. Ask, in one message:
  23. - Your name (used on your Instagram profile insert)
  24. - Your Instagram handle (for your profile insert and to pull your reels for the orbit effect)
  25. - Default look: **bold** (kinetic words behind your head), **cool girl** (warm, yellow serif italic, your reels
  26. orbiting you) or **cool dude** (dark editorial, tracked caps + serif). Offer bold if they are unsure.
  27. - Where your raw clips usually land (default `~/Downloads`) and where projects should live (default `~/reel-edits`)
  28. 3. Run the setup script with whichever Python the machine has. Try these in order until one prints STATUS lines:
  29. `python3 "SK/scripts/setup.py"`, then `python "SK/scripts/setup.py"`, then `py -3 "SK/scripts/setup.py"`.
  30. (On Windows `python3` is often a Microsoft Store stub that prints "Python was not found": just try the next one.)
  31. None of them runs: Python is missing. Give the fix for their system and stop (Windows:
  32. `winget install --id Python.Python.3.12 -e`, Mac: `brew install python`, Linux: `sudo apt install python3 python3-venv`).
  33. Then read the STATUS lines:
  34. - ffmpeg / node / python venv MISSING: the line ends with the exact fix for THIS machine (winget on Windows,
  35. brew on Mac, apt on Linux). Give it to the user and stop until the script prints READY.
  36. - Windows: the user pastes the winget lines into their own PowerShell window (winget asks them to agree to its
  37. terms the first time), then quits Claude Code completely and reopens it, or the new programs are not found.
  38. - The script downloads the 6 sound effects itself. If it still reports them MISSING (offline), that is optional:
  39. the reel just has no SFX until they are added.
  40. 4. Optional, Apify (pulls reels and profile stats automatically): try a simple Apify MCP call. If it is not
  41. connected, say it is optional and how to add it:
  42. 1. Create a free account at https://apify.com and copy the API token from Settings > API & Integrations.
  43. 2. In a terminal, paste this one line with the token in place of YOUR_TOKEN:
  44. `claude mcp add apify -e APIFY_TOKEN=YOUR_TOKEN -- npx -y @apify/actors-mcp-server`
  45. (heads up: Claude Code stores the token in plain text in `~/.claude.json`; keep that file private).
  46. 3. Reopen Claude and run /video-edit again.
  47. Without Apify, the skill asks them to drop their reel files into the project instead.
  48. 5. Save `SK/config.json` (no secrets, ever):
  49. ```json
  50. {"name": "...", "instagram": "handle-without-@", "defaultLook": "bold", "clipsDir": "~/Downloads",
  51. "projectsDir": "~/reel-edits", "setupComplete": true, "setupDate": "YYYY-MM-DD"}
  52. ```
  53. 6. Say: "Setup complete! Running /video-edit now..." and continue.
  54. ## This machine (read on every run)
  55. Read `SK/.platform.json`, written by setup.py. It records the OS (`os`: macos, linux or windows), the CPU and the
  56. exact commands for this computer:
  57. - `PY` = its `python` value: the skill's own Python (`.venv/bin/python` on Mac and Linux,
  58. `.venv/Scripts/python.exe` on Windows). Run EVERY Python script of this skill with it, never a bare `python3`.
  59. - `HF` = `PY "SK/scripts/hf.py"`: starts the pinned HyperFrames (`npx --yes hyperframes@0.8.34 ...`) with the
  60. right Node on any OS. No `nvm use`, no `npx.cmd` trouble.
  61. - `cutout`: `CoreML` (Apple Silicon) or `CPU` (Windows, Linux, Intel Macs: no GPU help, so the cutout step is the
  62. slow one; say so, run it in the background and keep building).
  63. setup.py rewrites this file on every run (Step 0), so it is always current. File missing, or `PY` no longer
  64. exists: setup did not run or did not reach READY; run it as in Step 0.3 and follow its fix.
  65. One command style that works in zsh, bash, Git Bash and PowerShell:
  66. - Full paths in double quotes with forward slashes (fine on Windows too): `"PY" "SK/scripts/ingest.py" "<project>"`.
  67. - In PowerShell (Windows without Git for Windows, or whenever the PowerShell tool is the one you have) put `&` in
  68. front: `& "PY" "SK/scripts/ingest.py" "<project>"`.
  69. - One command per call. No `&&`, no `VAR=1 command`, no `~` inside arguments, no `source`, no `zsh`.
  70. - `ffmpeg` and `ffprobe` are on PATH on every OS (setup checks it), so one-off ffmpeg commands are the same everywhere.
  71. ## Hard rules
  72. 1. Everything inside the Reels safe zone: top 220, bottom 450 (nothing below y 1470), sides 35, right 100 from y 1155.
  73. 2. Never cover the face with text or cards. Behind-head words show at least ~70% of each letter.
  74. 3. Captions say what was actually said: fix Whisper's mishearings of names and keywords ("Claude" often comes out
  75. as "cloud"/"claws", "skill" as "scale"). No em dashes in on-screen text.
  76. 4. Sound effects subtle (template `SFX_GAIN = 0.75` of the base volumes), never louder than the voice.
  77. 5. Credit other creators on screen (@handle) whenever their reels appear. Real numbers on the user's own profile;
  78. anything else (commenters, chat history) is a generic placeholder, never a real person, never fabricated proof.
  79. 6. Prove cuts from the final render, not from snapshots.
  80. 7. Never delete the user's files. Originals are read, never modified.
  81. ## Workflow
  82. ### 1. Intake
  83. - Clips: the files the user names, else the newest video files in `clipsDir`. Create `<projectsDir>/<short-slug>/`.
  84. (`~` in config.json is the user's home folder, `C:/Users/<name>` on Windows. The skill's scripts expand it.)
  85. - Reference links (IG reels, Pinterest pins) for a style: download them and look at frames before designing anything
  86. (see overlays.md for how to fetch them).
  87. ### 2. Ingest
  88. ```bash
  89. PY SK/scripts/ingest.py <project> <clips or folder> [--newest 5]
  90. ```
  91. Look at `work/sheets.jpg` (setups and angles) and read `transcript.txt` (per-clip lines, words with times, speech map).
  92. ### 3. Pick takes -> `<project>/edl.json`
  93. - Rebuild the script from the takes: people repeat a line until it lands. Use the LAST complete clean take unless
  94. the user says otherwise ("the better section starts at 0:47" means one continuous take from there).
  95. - In/out points from the speech map: start ~0.05-0.07s before the first word, end at the silence start after the
  96. last word. Kill dead air between sections; confirm short pauses with silencedetect before trimming (Whisper can
  97. invent a leading word at a cut).
  98. - Two segments in a row from the same angle: punch one in (zoom 1.3-1.9 from the 4K original, cx/cy on the chest).
  99. - Unsure words (keyword, CTA trigger): re-transcribe that snippet with medium.en and a prompt containing the names.
  100. - Format: `[{"id": "hook", "clip": "c1", "in": 12.66, "out": 15.72, "zoom": 1.0, "cx": 0.5, "cy": 0.5, "line": "..."}]`
  101. - Post the EDL to the user as a short table (line, clip, look per section) and keep going; do not wait.
  102. ### 4. Assemble, transcribe, cut out
  103. ```bash
  104. PY SK/scripts/assemble.py <project> # aroll.mp4 clean 30fps CFR + segments.json with exact frames
  105. PY SK/scripts/transcribe_cut.py <project> "<names and keywords in the script>"
  106. PY SK/scripts/cutout.py <project> # run in background; asserts cutout frames == aroll frames
  107. PY SK/scripts/headpos.py <project> # after the cutout: head/body position per segment
  108. ```
  109. One cutout at a time (about 1.5 GB of RAM). It prints a progress line every 30 seconds.
  110. ### 5. Inserts in parallel (as soon as the EDL is locked)
  111. For each animated insert the script calls for (an app on screen, the profile follow on the CTA, a file scroll),
  112. spawn a sub-agent in the background with the brief template in `references/overlays.md`: fixed size, fixed
  113. duration, beats locked to the word times, transparent webm out. Keep building the main edit while they work.
  114. ### 6. Build
  115. Copy `SK/assets/template/` into the project (build.py, hyperframes.json, package.json, assets/fonts, assets/sfx),
  116. then adapt build.py. It is the finished build of a real reel: keep the machinery, rewrite the content (its
  117. docstring lists which is which).
  118. - Which look where: `defaultLook` for the whole reel; a line that names a look switches its section.
  119. - Orbit and profile grid use the user's own reels (overlays.md: Apify post scraper with their handle, or files they
  120. drop into `assets/reels/`).
  121. - Iterate from the project folder: `HF lint` (0 errors), then `PY build.py --safe`, then
  122. `HF snapshot --at <10-20 moments> --no-end --describe false`. Read the contact sheets, fix layout, readability
  123. and safe zone. (`HF` picks the right Node by itself, so there is no `nvm use`.)
  124. A build.py copied from an older version of this skill ignores `--safe`: if the red guide is missing from the
  125. snapshots, build that project the old way, `SAFE=1 "PY" build.py` (such projects only exist on Mac and Linux).
  126. ### 7. Render and QA
  127. ```bash
  128. PY build.py # without --safe
  129. HF render -o renders/<slug>-vN.mp4 --quality high # ~1.5-2 min for a 25s reel on Apple Silicon
  130. PY SK/scripts/check_cuts.py <project> renders/<slug>-vN.mp4 --phone
  131. ```
  132. Look at `work/cut_check.jpg`: every after-cut frame shows the new shot cleanly. Check audio peaks (`volumedetect`,
  133. max around -2 to -5 dB) and the silence at section joins.
  134. ### 8. Deliver
  135. Send or point to the phone copy (720p) and the full-quality render. Report in plain terms what changed and anything
  136. that needs the user's call. Keep every version in `renders/`; back up `assets/` + `segments.json` to `work/vN/` before
  137. re-assembling.
  138. ## Defaults that came out of real feedback (do not re-litigate)
  139. - Change the grade and captions to create a look; do not replace the background with an AI-generated room.
  140. - No film grain. Dark is fine, but keep the subject lit and skin from going red.
  141. - Lead-in captions centred in front of the speaker read better than lines pinned to the left edge.
  142. - Words behind the head are the signature move, but only when readable.
  143. ---
  144. Built by [@tenfoldmarc](https://instagram.com/tenfoldmarc). Follow for daily AI automation builds, real systems, not theory.
README.md · README · 131 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Video Edit
  2. ### A Claude Code Skill by [@tenfoldmarc](https://www.instagram.com/tenfoldmarc)
  3. Film your talking-head clips on your phone, drop them in a folder, type `/video-edit`, and Claude turns them into a finished Instagram reel. It picks your best take of every line, cuts the dead air, cuts you out of the background so words can sit behind your head, and applies a designed look with captions, motion graphics and sound. You never open an editor: you watch the result, say what you want changed, and it re-renders in about two minutes.
  4. ---
  5. ## What It Does
  6. 1. Finds your clips, makes contact sheets and transcribes every take with word-level timing.
  7. 2. Rebuilds your script from your takes (you can repeat lines as many times as you want) and keeps the cleanest one of each, with zero dead air between sections.
  8. 3. Cuts the reel straight from your original files, with sharp punch-ins from 4K for variety.
  9. 4. Cuts you out of the background, so big words can sit behind your head.
  10. 5. Applies one of three looks:
  11. - **Bold:** kinetic words around you, the big ones behind your head.
  12. - **Cool girl:** a warm grade with a yellow serif italic, and your own reels orbiting around you.
  13. - **Cool dude:** a dark editorial grade with tiny spaced capitals and big serif words.
  14. 6. Builds animated inserts in parallel with sub-agents: an app on screen behind you, your Instagram profile getting followed on your call to action, a file scrolling.
  15. 7. Keeps everything inside the Instagram safe zone, checks every cut frame by frame, and hands you a phone-ready copy.
  16. ---
  17. ## Requirements
  18. - A Mac, a Windows 10/11 PC or a Linux computer. Apple Silicon Macs are fastest for the background cutout; on Windows and Linux that one step runs on the processor, so it takes longer.
  19. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and working
  20. - [ffmpeg](https://ffmpeg.org)
  21. - [Node.js 22 or newer](https://nodejs.org)
  22. - Python 3.10 or newer ([python.org](https://www.python.org/downloads/))
  23. - Optional: an [Apify](https://apify.com) account (free tier works) to pull your reels and profile stats automatically
  24. Don't worry about connecting these manually. On first run the skill checks your computer, figures out whether it's a Mac, a PC or Linux, and gives you the exact line to paste for anything that's missing.
  25. | | Mac | Windows (PowerShell) | Linux |
  26. |---|---|---|---|
  27. | ffmpeg | `brew install ffmpeg` | `winget install --id Gyan.FFmpeg -e` | `sudo apt install ffmpeg` |
  28. | Node.js | `brew install node` | `winget install --id OpenJS.NodeJS.LTS -e` | [nodejs.org](https://nodejs.org) |
  29. | Python | `brew install python` | `winget install --id Python.Python.3.12 -e` | `sudo apt install python3 python3-venv` |
  30. **Windows support is new.** The skill was built and tested on a Mac, and Windows has not had that level of real-world testing yet. If something breaks on your PC, please [open an issue](https://github.com/tenfoldmarc/video-edit-skill/issues) with the error text and the `STATUS` lines the setup printed.
  31. **On Windows:** each line is one paste into PowerShell. After installing, close Claude Code completely and open it again, or it won't see the new programs. Git for Windows is optional (the skill works with or without it). On a Windows ARM laptop (Snapdragon), add `--architecture x64` to the Python line.
  32. ---
  33. ## Install
  34. No terminal needed.
  35. ### Step 1: Open Claude Code
  36. Open Claude Code: the Code tab in the Claude desktop app, or type `claude` in your terminal. (This skill renders video on your computer, so it needs Claude Code; a regular chat can't run it.)
  37. ### Step 2: Paste this message
  38. Copy-paste this into the chat and hit Enter:
  39. ```
  40. Install this skill for me: https://github.com/tenfoldmarc/video-edit-skill
  41. ```
  42. Claude downloads the skill into your skills folder and tells you when it's ready. Takes a few seconds.
  43. ### Step 3: Run the skill
  44. Type:
  45. ```
  46. /video-edit
  47. ```
  48. Hit Enter. On your first run, the skill asks your name, your Instagram handle and your favorite look, checks your tools and sets up everything it needs (about 2 minutes, once). Just follow the prompts.
  49. <details>
  50. <summary>Prefer the terminal? Manual install</summary>
  51. Open Terminal (Mac: `Command + Space`, type Terminal. Windows: Start menu, type PowerShell). Paste this one line and hit Enter (it needs [git](https://git-scm.com/downloads) installed):
  52. ```bash
  53. git clone https://github.com/tenfoldmarc/video-edit-skill "$HOME/.claude/skills/video-edit"
  54. ```
  55. Then type `claude` to open Claude Code and run `/video-edit`.
  56. </details>
  57. ---
  58. ## Usage
  59. **Edit today's clips:**
  60. ```
  61. /video-edit I just dropped 5 clips in my downloads
  62. ```
  63. Claude finds them, shows you which take it picked for each line, and sends you the finished reel.
  64. **Name the look per section:**
  65. ```
  66. /video-edit use the cool girl look when I say "the cool girl aesthetic", cool dude after that, bold everywhere else
  67. ```
  68. **Give notes on a version:**
  69. ```
  70. the captions feel too small, the grain is too much, and cut the pause before "or you can get"
  71. ```
  72. It fixes exactly that and re-renders in about two minutes.
  73. Tips for filming: shoot vertical in 4K if your phone allows (punch-ins stay sharp), keep the camera still for each setup, and repeat a line until it feels right. The skill picks the best take.
  74. ---
  75. ## Updating
  76. Paste this into Claude:
  77. ```
  78. Update the video-edit skill from https://github.com/tenfoldmarc/video-edit-skill
  79. ```
  80. Or in Terminal / PowerShell: `git -C "$HOME/.claude/skills/video-edit" pull`
  81. ---
  82. ## Credits
  83. Built on [HyperFrames](https://github.com/heygen-com/hyperframes) (HTML-to-video rendering and background removal) and [faster-whisper](https://github.com/SYSTRAN/faster-whisper). Fonts from Google Fonts (SIL Open Font License). Sound effects from Pixabay, downloaded on setup.
  84. ---
  85. ## Built By
  86. [@tenfoldmarc](https://www.instagram.com/tenfoldmarc). Follow for daily AI automation walkthroughs, real systems, not theory.

Ratings and comments

Sign in to rate this skill.

Sign in

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