Communitygithub.com

halo-cut

Halo Cut video-editing style for Claude: Clean premium reel: tight jump cuts, word-by-word captions, zoom punches on key words. Use for any talking-head clip for Reels, Shorts or TikTok: tips, opinions, stories, announcements. Turns a raw clip into a finished 9:16 edit with the video-studio-core engine (transcribe, auto-cut, motion graphics, sound, grade).

What is halo-cut?

halo-cut is a Claude Code agent skill that halo Cut video-editing style for Claude: Clean premium reel: tight jump cuts, word-by-word captions, zoom punches on key words. Use for any talking-head clip for Reels, Shorts or TikTok: tips, opinions, stories, announcements. Turns a raw clip into a finished 9:16 edit with the video-studio-core engine (transcribe, auto-cut, motion graphics, sound, grade).

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/halo-cut

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Halo Cut

Clean premium reel: tight jump cuts, word-by-word captions, zoom punches on key words.

  • Best for: any talking-head clip for Reels, Shorts or TikTok: tips, opinions, stories, announcements
  • 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 = the video-studio-core folder next to this one (e.g. ~/.claude/skills/video-studio-core).
  • STYLE = this skill's folder (it holds theme.json and theme.css).
  • First time on a machine: python CORE/scripts/check_env.py, and fix anything it reports.
  • If CORE is missing, tell the user to install video-studio-core from the same pack.

Make the edit

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-halo-cut --stop-after plan
# refine edit-*/plan.json (see below), then check stills:
python CORE/scripts/render.py edit-halo-cut/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-halo-cut/plan.json
python CORE/scripts/finish.py edit-halo-cut/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

  • Captions sit at 70% height, 2-3 words at a time, uppercase, spoken word in yellow, key words in cyan.
  • Zoom punch (+14%, then +8%) on every strong word, never more than one every 2.4 s.
  • Hook box at the top for the first 2.4 s: rewrite it to 4-7 words that promise the payoff.
  • Soft swish on jump cuts, pop on key words. Nothing else on screen.

Refine the plan

The draft from make_plan.py is automatic. Make it good:

  • Read words.json and 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 words array (keep their times).
  • Pick 4-8 key words that carry the message and put them in the captions element's keywords list.
  • Match speaker.zooms to those words (start 0.05 s before the word, end ~1 s later).
  • If the clip ends on a call to action, add an endcard text element in the last 2 s.
  • 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.
  • ffprobe the 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

  • "Edit my clip with halo-cut. Cut every pause."
  • "Make this a premium reel, captions on, zoom on the important words."
  • "Halo-cut this, hook should be 'I quit my job for this'."

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Related Skills