gta-clipper
Turns one stream or gameplay link (YouTube, Twitch, Kick, TikTok) or a video file into finished vertical Shorts of its best moments, with the streamer's facecam on top, gameplay below, word-by-word captions and a black hook pill first. Runs on the user's own Mac or Windows PC, free, no account or key. Use when someone wants to clip a stream, make GTA (or any game) Shorts from a link, says "clip this", or says "set up GTA Clipper".
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/macoveigabriela8--gta-clipper)HTML
<a href="/listings/macoveigabriela8--gta-clipper"><img src="/api/listings/macoveigabriela8--gta-clipper/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
> Install the GTA Clipper skill from https://github.com/macoveigabriela8/gta-clipper and set it up, then clip this: PASTE-YOUR-STREAM-LINK
Works with YouTube, Twitch (VODs and clips), Kick, TikTok, or a video file on your computer.
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 · 109 lines
- ---
- name: gta-clipper
- description: Turns one stream or gameplay link (YouTube, Twitch, Kick, TikTok) or a video file into finished vertical Shorts of its best moments, with the streamer's facecam on top, gameplay below, word-by-word captions and a black hook pill first. Runs on the user's own Mac or Windows PC, free, no account or key. Use when someone wants to clip a stream, make GTA (or any game) Shorts from a link, says "clip this", or says "set up GTA Clipper".
- ---
- # GTA Clipper
- One link in, 2-3 finished Shorts out. The heavy work (download, listening, facecam, edit) runs on the user's computer
- through one script. Your job is the taste: which moments, where each starts and ends, and the hook. Talk in plain
- words; the user is often not technical. Show only the lines that matter from each command.
- **The command** (works the same on Mac and Windows, from any folder):
- `uv run --python 3.12 "<this skill's folder>/scripts/gc.py" <command>` — below written as `gc <command>`.
- This skill's folder is the one holding this SKILL.md (normally `~/.claude/skills/gta-clipper`, on Windows
- `%USERPROFILE%\.claude\skills\gta-clipper`).
- ## First run (do it all, one go)
- 1. **uv** (it brings Python and every library; no admin, no password). Check `uv --version`. If missing:
- - Mac: `curl -LsSf https://astral.sh/uv/install.sh | sh`
- - Windows (PowerShell): `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
- Then use the full path until a new terminal opens: Mac `~/.local/bin/uv`, Windows `$env:USERPROFILE\.local\bin\uv.exe`.
- If `uv run --python 3.12` fails on Windows with a link/shortcut error, run `uv python find 3.12` and pass that
- full python.exe path to `--python` instead (some Windows Servers break uv's Python shortcut).
- 2. `gc setup` — installs the libraries and downloads the speech model once (about 1-2 minutes). Wait for "Ready".
- Then SHOW the user the 3 kinds: `gc formats` opens `assets/formats.jpg` (real frames of each kind, side by
- side) on their screen; also give its path as a link. Say with it: "This is what I can make: 1 streamer moments (face on top,
- game below), 2 full gameplay (when there's no webcam), 3 a Top 5 countdown. I'll pick what fits your stream."
- 3. `gc get "<link or file>"` — downloads the video (long streams: the first 40 min; `--minutes 90` for more), listens
- to it and writes `scan/chunk_*.md` in a new project under `~/GTAClipper/projects/`.
- 4. Read `reference/cutting-sop.md` (the cutting rules and the QA), then every chunk file. Lines marked 🔥🔥 / 🔥
- are the loudest, wildest seconds. Find every moment worth a Short (below) and check each window with
- `gc look "<video>" --from 6:40 --to 7:16 --every 3` (read the contact sheet): you must SEE the setup and the
- payoff inside it.
- 5. **Always ask, even for one moment** (unless they already said how many, or "you choose"): list what you found,
- best first, one line each (time, length, the hook), then "I found N clippable moments. Make just the best one,
- or all N? Each takes about 10 seconds." With one: "I found 1 clippable moment: … Make it, or pick a different
- part?" **The format is your call, said inside that same question** (no extra step): the layout follows the
- webcam (found: face on top; none: full gameplay), and with 5+ decent moments add one Top 5 countdown: "I found
- 7 moments. I'll make the best 3 as Shorts plus one Top 5 countdown. Go, or just the best one?" The user can
- still say "only the Top 5" or "full gameplay". Top 5 rules and its plan shape: `reference/cutting-sop.md` § 7.
- Then write the chosen ones into the project's `plan.json` under `"moments"`:
- `{"a": 401, "b": 435, "hook": "He just paid 25K for this truck", "caption": "Never complain out loud #gtarp",
- "payoff": "the truck flips into the river", "payoff_at": 432.5}`
- (`a` / `b` / `payoff_at` in seconds of the video; end 1-3 s after the payoff). "You choose" = the best 3.
- 6. `gc make "<project folder>" --no-open` — renders them one by one (and the `"top5"`, when the plan has one) and
- runs the QA on each (below).
- 7. **QA, never skipped.** Fix every ✗ the make printed (the fix for each is in `reference/cutting-sop.md` § 6),
- then Read every `<name>_qa.jpg` it lists and do the eye check (§ 5): real webcam on top, no second set of
- captions, the last 4 frames land on the payoff. Make again until clean (two rounds at most; then drop that
- moment and say why). Only then open the review page (`~/GTAClipper/shorts/<date>/index.html`) and tell the
- user where the Shorts are, one line each: "✓ QA passed" or what you fixed.
- **Keep the user posted, in the chat itself** (the app folds command output away, so they won't see it unless you say
- it). Before every step, one line with what happens and how long:
- - setup: "Installing the tools, about 1-2 minutes (only the first time)."
- - get: "Downloading and listening to the stream: about 1-3 min per 10 min of video (this one is N min)."
- - make: "Making N Shorts and checking each one, about 15-30 seconds each."
- Add once: "You can click the running step to watch it live." After each step, say what came out in one line
- ("Heard 755 words, 15 hot moments", "Short 1 of 3 done").
- No link given? Ask for one: a YouTube video or VOD, a Twitch VOD or clip, or a video file on the computer.
- ## Picking a moment
- - Keep it if someone with the sound off gets it in two seconds, and it has a setup and a payoff (the plan, then what
- really happened). End right after the payoff (the reaction, the explosion, the "no way").
- - Window: start 3-6 s before the setup, end 1-3 s after the payoff. 15-45 s.
- - **The payoff must be inside the link.** A short clip (a 30 s Twitch clip) often stops mid-scene where the viewer
- who cut it stopped. If the payoff isn't there, say so and ask for a longer link (the full stream or VOD); never
- hand over a Short whose ending doesn't land.
- - Prefer moments where the streamer talks or reacts out loud: when only the game is heard, the captions stay empty
- and the Short loses the streamer (QA warns under 0.5 words a second).
- - Never put a 🔇 silent stretch (listed in the notes) inside a window: start after it or end before it. Silence at
- the very start or end of a Short is trimmed for you; silence of 2 s or more in the middle makes the Short come
- back "needs a look" with the second it happens. Then move the window or split it into two moments and make it
- again. Don't hand over a Short with a silent middle.
- - Drop it if it needs five minutes of context, has music or radio playing (claims), or is a menu or loading screen.
- - A compilation (several streamers): each moment finds its own facecam; stay inside one clip.
- ## The hook (the black pill, on screen from the first frame, 3 s)
- 5-9 words. Say what's about to happen, never the payoff. Formulas that keep working:
- - **He thought X…** — "He thought the van could swim"
- - **Stakes** — "He just paid 25K for this truck"
- - **Wait for it** — "Wait for the cop's reaction"
- - **POV** — "POV: you trust your GTA RP friend"
- - **Number** — "He tried this 47 times"
- - **Question** — "Can a car actually float in GTA?"
- Write it like you'd text a friend. No emoji, no hashtags in the hook.
- ## If something goes wrong
- - `gc doctor` checks every piece. Setup problems: run `gc setup` again (it only fetches what's missing).
- - No facecam found → the Short uses the gameplay full height (that's fine). Wrong face picked → set
- `"facecam": false` on that moment, or give `"cam": {"x":..,"y":..,"w":..,"h":..}` in the video's pixels.
- - Game subtitles or stream captions still showing under ours → `"drop_bottom": 0.25` on that moment (the share of
- the picture's height cut off the bottom; the tool finds most of them by itself).
- - A link fails → `gc get` already tries five YouTube players, waits and tries again. Still failing: YouTube is
- rate-limiting this computer. Offer, in this order: a Twitch / Kick link of the same stream, trying again in a few
- minutes, or the video file. Optional paid backup for YouTube: if the user has an Apify token, save it as
- `"apify_token"` in `~/GTAClipper/settings.json` (never print it back) and run `gc get` again; it costs cents,
- capped at $1 a video.
- ## Honest notes for the user
- Only clip streamers who are fine with it (many invite clippers), or add your own reaction or voice: platforms pay
- less, or nothing, for re-uploads with nothing new in them. Footage you recorded yourself is always yours to post.
- Views are never guaranteed.
README.md · README · 31 lines
- # GTA Clipper
- One stream link in, finished vertical Shorts out: the streamer's face on top, the game below, word captions, and a
- black hook pill as the first thing on screen. Free, runs on your own Mac or Windows PC.
- 
- ## Install: paste this one sentence into the Claude app (Code tab)
- > Install the GTA Clipper skill from https://github.com/macoveigabriela8/gta-clipper and set it up, then clip this: PASTE-YOUR-STREAM-LINK
- Works with YouTube, Twitch (VODs and clips), Kick, TikTok, or a video file on your computer.
- ## If you are Claude, installing this for the user
- 1. Put this repository in the user's skills folder as `gta-clipper` (no git needed):
- - Mac: `mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o gc.zip https://github.com/macoveigabriela8/gta-clipper/archive/refs/heads/main.zip && unzip -q -o gc.zip && rm -rf gta-clipper && mv gta-clipper-main gta-clipper && rm gc.zip`
- - Windows (PowerShell): `$s="$env:USERPROFILE\.claude\skills"; New-Item -ItemType Directory -Force $s | Out-Null; Invoke-WebRequest https://github.com/macoveigabriela8/gta-clipper/archive/refs/heads/main.zip -OutFile "$s\gc.zip"; Expand-Archive "$s\gc.zip" $s -Force; Remove-Item "$s\gta-clipper" -Recurse -Force -ErrorAction SilentlyContinue; Rename-Item "$s\gta-clipper-main" gta-clipper; Remove-Item "$s\gc.zip"`
- 2. Read `gta-clipper/SKILL.md` there and follow "First run" with the link the user gave you. Everything installs
- through `uv`: no Homebrew, no admin, no password.
- ## What you get
- 2-3 Shorts per stream (15-45 s, 1080x1920) in `~/GTAClipper/shorts/<date>/`, each with a post caption, and a review
- page that opens when they're done. Formats: **streamer moments** (face on top, game below), **full gameplay** (when
- the stream has no webcam) and a **Top 5 countdown** (five short moments, #5 to #1, one Short, a whoosh at each rank change) when a stream has 5+
- good moments. Claude picks the format that fits. Every Short passes an automatic QA first (sound level, dead air, no double
- captions, the real webcam on top, an ending that lands on the payoff), and Claude looks at its frames.
- The rules are in `reference/cutting-sop.md`. Watch each one before you post it.
- Fonts: Anton and Montserrat, SIL Open Font License (`assets/fonts/OFL.txt`).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.