Skip to content
Back to search

gta-clipper

SkillWorks with Claude CodeGitHub

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/macoveigabriela8--gta-clipper/badge.svg)](/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

i

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
  1. ---
  2. name: gta-clipper
  3. 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".
  4. ---
  5. # GTA Clipper
  6. One link in, 2-3 finished Shorts out. The heavy work (download, listening, facecam, edit) runs on the user's computer
  7. through one script. Your job is the taste: which moments, where each starts and ends, and the hook. Talk in plain
  8. words; the user is often not technical. Show only the lines that matter from each command.
  9. **The command** (works the same on Mac and Windows, from any folder):
  10. `uv run --python 3.12 "<this skill's folder>/scripts/gc.py" <command>` — below written as `gc <command>`.
  11. This skill's folder is the one holding this SKILL.md (normally `~/.claude/skills/gta-clipper`, on Windows
  12. `%USERPROFILE%\.claude\skills\gta-clipper`).
  13. ## First run (do it all, one go)
  14. 1. **uv** (it brings Python and every library; no admin, no password). Check `uv --version`. If missing:
  15. - Mac: `curl -LsSf https://astral.sh/uv/install.sh | sh`
  16. - Windows (PowerShell): `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
  17. Then use the full path until a new terminal opens: Mac `~/.local/bin/uv`, Windows `$env:USERPROFILE\.local\bin\uv.exe`.
  18. If `uv run --python 3.12` fails on Windows with a link/shortcut error, run `uv python find 3.12` and pass that
  19. full python.exe path to `--python` instead (some Windows Servers break uv's Python shortcut).
  20. 2. `gc setup` — installs the libraries and downloads the speech model once (about 1-2 minutes). Wait for "Ready".
  21. Then SHOW the user the 3 kinds: `gc formats` opens `assets/formats.jpg` (real frames of each kind, side by
  22. 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,
  23. game below), 2 full gameplay (when there's no webcam), 3 a Top 5 countdown. I'll pick what fits your stream."
  24. 3. `gc get "<link or file>"` — downloads the video (long streams: the first 40 min; `--minutes 90` for more), listens
  25. to it and writes `scan/chunk_*.md` in a new project under `~/GTAClipper/projects/`.
  26. 4. Read `reference/cutting-sop.md` (the cutting rules and the QA), then every chunk file. Lines marked 🔥🔥 / 🔥
  27. are the loudest, wildest seconds. Find every moment worth a Short (below) and check each window with
  28. `gc look "<video>" --from 6:40 --to 7:16 --every 3` (read the contact sheet): you must SEE the setup and the
  29. payoff inside it.
  30. 5. **Always ask, even for one moment** (unless they already said how many, or "you choose"): list what you found,
  31. best first, one line each (time, length, the hook), then "I found N clippable moments. Make just the best one,
  32. or all N? Each takes about 10 seconds." With one: "I found 1 clippable moment: … Make it, or pick a different
  33. part?" **The format is your call, said inside that same question** (no extra step): the layout follows the
  34. webcam (found: face on top; none: full gameplay), and with 5+ decent moments add one Top 5 countdown: "I found
  35. 7 moments. I'll make the best 3 as Shorts plus one Top 5 countdown. Go, or just the best one?" The user can
  36. still say "only the Top 5" or "full gameplay". Top 5 rules and its plan shape: `reference/cutting-sop.md` § 7.
  37. Then write the chosen ones into the project's `plan.json` under `"moments"`:
  38. `{"a": 401, "b": 435, "hook": "He just paid 25K for this truck", "caption": "Never complain out loud #gtarp",
  39. "payoff": "the truck flips into the river", "payoff_at": 432.5}`
  40. (`a` / `b` / `payoff_at` in seconds of the video; end 1-3 s after the payoff). "You choose" = the best 3.
  41. 6. `gc make "<project folder>" --no-open` — renders them one by one (and the `"top5"`, when the plan has one) and
  42. runs the QA on each (below).
  43. 7. **QA, never skipped.** Fix every ✗ the make printed (the fix for each is in `reference/cutting-sop.md` § 6),
  44. then Read every `<name>_qa.jpg` it lists and do the eye check (§ 5): real webcam on top, no second set of
  45. captions, the last 4 frames land on the payoff. Make again until clean (two rounds at most; then drop that
  46. moment and say why). Only then open the review page (`~/GTAClipper/shorts/<date>/index.html`) and tell the
  47. user where the Shorts are, one line each: "✓ QA passed" or what you fixed.
  48. **Keep the user posted, in the chat itself** (the app folds command output away, so they won't see it unless you say
  49. it). Before every step, one line with what happens and how long:
  50. - setup: "Installing the tools, about 1-2 minutes (only the first time)."
  51. - get: "Downloading and listening to the stream: about 1-3 min per 10 min of video (this one is N min)."
  52. - make: "Making N Shorts and checking each one, about 15-30 seconds each."
  53. Add once: "You can click the running step to watch it live." After each step, say what came out in one line
  54. ("Heard 755 words, 15 hot moments", "Short 1 of 3 done").
  55. No link given? Ask for one: a YouTube video or VOD, a Twitch VOD or clip, or a video file on the computer.
  56. ## Picking a moment
  57. - 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
  58. really happened). End right after the payoff (the reaction, the explosion, the "no way").
  59. - Window: start 3-6 s before the setup, end 1-3 s after the payoff. 15-45 s.
  60. - **The payoff must be inside the link.** A short clip (a 30 s Twitch clip) often stops mid-scene where the viewer
  61. who cut it stopped. If the payoff isn't there, say so and ask for a longer link (the full stream or VOD); never
  62. hand over a Short whose ending doesn't land.
  63. - Prefer moments where the streamer talks or reacts out loud: when only the game is heard, the captions stay empty
  64. and the Short loses the streamer (QA warns under 0.5 words a second).
  65. - Never put a 🔇 silent stretch (listed in the notes) inside a window: start after it or end before it. Silence at
  66. 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
  67. back "needs a look" with the second it happens. Then move the window or split it into two moments and make it
  68. again. Don't hand over a Short with a silent middle.
  69. - Drop it if it needs five minutes of context, has music or radio playing (claims), or is a menu or loading screen.
  70. - A compilation (several streamers): each moment finds its own facecam; stay inside one clip.
  71. ## The hook (the black pill, on screen from the first frame, 3 s)
  72. 5-9 words. Say what's about to happen, never the payoff. Formulas that keep working:
  73. - **He thought X…** — "He thought the van could swim"
  74. - **Stakes** — "He just paid 25K for this truck"
  75. - **Wait for it** — "Wait for the cop's reaction"
  76. - **POV** — "POV: you trust your GTA RP friend"
  77. - **Number** — "He tried this 47 times"
  78. - **Question** — "Can a car actually float in GTA?"
  79. Write it like you'd text a friend. No emoji, no hashtags in the hook.
  80. ## If something goes wrong
  81. - `gc doctor` checks every piece. Setup problems: run `gc setup` again (it only fetches what's missing).
  82. - No facecam found → the Short uses the gameplay full height (that's fine). Wrong face picked → set
  83. `"facecam": false` on that moment, or give `"cam": {"x":..,"y":..,"w":..,"h":..}` in the video's pixels.
  84. - Game subtitles or stream captions still showing under ours → `"drop_bottom": 0.25` on that moment (the share of
  85. the picture's height cut off the bottom; the tool finds most of them by itself).
  86. - A link fails → `gc get` already tries five YouTube players, waits and tries again. Still failing: YouTube is
  87. rate-limiting this computer. Offer, in this order: a Twitch / Kick link of the same stream, trying again in a few
  88. minutes, or the video file. Optional paid backup for YouTube: if the user has an Apify token, save it as
  89. `"apify_token"` in `~/GTAClipper/settings.json` (never print it back) and run `gc get` again; it costs cents,
  90. capped at $1 a video.
  91. ## Honest notes for the user
  92. Only clip streamers who are fine with it (many invite clippers), or add your own reaction or voice: platforms pay
  93. less, or nothing, for re-uploads with nothing new in them. Footage you recorded yourself is always yours to post.
  94. Views are never guaranteed.
README.md · README · 31 lines
  1. # GTA Clipper
  2. One stream link in, finished vertical Shorts out: the streamer's face on top, the game below, word captions, and a
  3. black hook pill as the first thing on screen. Free, runs on your own Mac or Windows PC.
  4. ![The 3 kinds of Short: streamer moments, full gameplay, Top 5 countdown](assets/formats.jpg)
  5. ## Install: paste this one sentence into the Claude app (Code tab)
  6. > Install the GTA Clipper skill from https://github.com/macoveigabriela8/gta-clipper and set it up, then clip this: PASTE-YOUR-STREAM-LINK
  7. Works with YouTube, Twitch (VODs and clips), Kick, TikTok, or a video file on your computer.
  8. ## If you are Claude, installing this for the user
  9. 1. Put this repository in the user's skills folder as `gta-clipper` (no git needed):
  10. - 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`
  11. - 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"`
  12. 2. Read `gta-clipper/SKILL.md` there and follow "First run" with the link the user gave you. Everything installs
  13. through `uv`: no Homebrew, no admin, no password.
  14. ## What you get
  15. 2-3 Shorts per stream (15-45 s, 1080x1920) in `~/GTAClipper/shorts/<date>/`, each with a post caption, and a review
  16. page that opens when they're done. Formats: **streamer moments** (face on top, game below), **full gameplay** (when
  17. 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+
  18. good moments. Claude picks the format that fits. Every Short passes an automatic QA first (sound level, dead air, no double
  19. captions, the real webcam on top, an ending that lands on the payoff), and Claude looks at its frames.
  20. The rules are in `reference/cutting-sop.md`. Watch each one before you post it.
  21. Fonts: Anton and Montserrat, SIL Open Font License (`assets/fonts/OFL.txt`).

Ratings and comments

Sign in to rate this skill.

Sign in

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