Skip to content
Back to search

zclipper

MarketplaceWorks with Claude CodeGitHub

zclipper: a Claude skill that turns YouTube, Twitch and Kick streams into vertical clips with captions.

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/misterzaidxpy--zclipper/badge.svg)](/listings/misterzaidxpy--zclipper)

HTML

<a href="/listings/misterzaidxpy--zclipper"><img src="/api/listings/misterzaidxpy--zclipper/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.

Requirements

- Python 3.10 or newer - [ffmpeg](https://ffmpeg.org) on PATH: `winget install Gyan.FFmpeg` (Windows), `brew install ffmpeg` (macOS), `sudo apt install ffmpeg` (Linux) - The Python packages:

  pip install -U yt-dlp pydantic curl_cffi

- Optional, for videos and live clips without captions (local speech-to-text):

  pip install faster-whisper numpy

Claude Code

Pick one.

**Skills CLI**

npx skills add misterzaidxpy/zclipper -a claude-code

**Plugin marketplace** (updates arrive with new versions)

/plugin marketplace add misterzaidxpy/zclipper
/plugin install zclipper@zclipper

**Ask Claude to install it**

> Install the ZClipper skill from https://github.com/misterzaidxpy/zclipper: clone the repository and copy its `skills/zclipper` folder to `~/.claude/skills/zclipper`.

Restart Claude Code, then ask **"run the ZClipper doctor"** to check that everything is in place.

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.

.claude-plugin/marketplace.json · Manifest · 20 lines
  1. {
  2. "name": "zclipper",
  3. "description": "zclipper: a Claude skill that turns YouTube, Twitch and Kick streams into vertical clips with captions.",
  4. "owner": {
  5. "name": "Muhammad Zaid"
  6. },
  7. "plugins": [
  8. {
  9. "name": "zclipper",
  10. "source": "./",
  11. "description": "Ask for the best moments of a game, a topic or a streamer's livestream and get finished 9:16 clips with captions, facecam on top and gameplay below. Runs locally, no API keys.",
  12. "version": "0.1.0",
  13. "author": {
  14. "name": "Muhammad Zaid"
  15. },
  16. "license": "MIT",
  17. "keywords": ["clipping", "shorts", "youtube", "twitch", "kick", "gta6"]
  18. }
  19. ]
  20. }
README.md · README · 233 lines
  1. <h1 align="center">ZClipper</h1>
  2. <p align="center">
  3. <b>Ask Claude for the best moments of a stream. Get finished vertical clips back in chat.</b>
  4. </p>
  5. <p align="center">
  6. <a href="LICENSE"><img src="https://img.shields.io/github/license/misterzaidxpy/zclipper?style=flat-square&color=green" alt="License: MIT"></a>
  7. <img src="https://img.shields.io/badge/python-3.10%2B-yellow?style=flat-square&logo=python&logoColor=white" alt="Python 3.10+">
  8. <img src="https://img.shields.io/badge/Claude_Code-skill_%2B_plugin-D97757?style=flat-square" alt="Claude Code skill and plugin">
  9. <img src="https://img.shields.io/badge/sources-YouTube%20%7C%20Twitch%20%7C%20Kick-blue?style=flat-square" alt="YouTube, Twitch and Kick">
  10. <img src="https://img.shields.io/badge/API_keys-none-lightgrey?style=flat-square" alt="No API keys">
  11. </p>
  12. <p align="center">
  13. <img src="docs/demo.gif" alt="A ZClipper clip: webcam on top, gameplay below, word-by-word captions" width="270">
  14. </p>
  15. ZClipper is a Claude skill that turns YouTube, Twitch and Kick streams into short vertical clips with word-by-word captions: the streamer's facecam on top, the gameplay below, ready for Shorts, TikTok and Reels. It finds the videos, measures where the best moments are, cuts only those seconds and renders the clips on your own computer. Claude does the judging: which moments are worth posting, where to cut, and the title, caption and hashtags for each clip.
  16. No paid APIs, no credits, no upload to a clipping service.
  17. ## Table of Contents
  18. - [How it works](#how-it-works)
  19. - [What you get](#what-you-get)
  20. - [Installation](#installation)
  21. - [Usage](#usage)
  22. - [What's inside](#whats-inside)
  23. - [Commands](#commands)
  24. - [Limits](#limits)
  25. - [Updating](#updating)
  26. - [Contributing](#contributing)
  27. - [License](#license)
  28. ## How it works
  29. You ask in plain words. The skill triggers on its own and Claude takes it from there:
  30. 1. **Find the source.** For a topic ("GTA 6") it searches YouTube for the most viewed long videos and past streams of the week. For a streamer it checks YouTube, Twitch and Kick at once to see where they are live, and lists their latest finished streams.
  31. 2. **Find the moments.** On YouTube, the "most replayed" graph and bursts of fast speech and reactions in the captions give a ranked list of candidates with what was said. On a live stream, ZClipper reads the chat and marks the moments when it explodes; on Twitch and Kick it can also use the clips viewers already made.
  32. 3. **Pick and write.** Claude reads the candidates, keeps the ones a viewer with no context would still enjoy, tightens the cuts, and writes the post copy.
  33. 4. **Cut and render.** Only the chosen seconds are downloaded, so a 6 hour stream never lands on your disk. Each clip is rendered with captions and a thumbnail.
  34. 5. **Reply.** Claude answers in chat with every clip's file, title, caption, hashtags and thumbnail.
  35. ## What you get
  36. Every clip is 1080x1920 by default:
  37. ```
  38. +--------------------+
  39. | |
  40. | facecam | the streamer's webcam, cropped and sharpened
  41. | |
  42. |== BIG CAPTIONS ====| word-by-word, the spoken word in yellow
  43. | |
  44. | |
  45. | gameplay | cropped to fill, slid away from the webcam
  46. | | so the streamer never shows up twice
  47. | |
  48. +--------------------+
  49. ```
  50. - **No facecam?** The gameplay fills the whole 9:16 frame, with a title bar on top.
  51. - **Another shape?** Ask for 4:5, 1:1 or 16:9 and captions and thumbnails scale to fit.
  52. - **With every clip:** a `.jpg` thumbnail with the punchline in big type, and `clips.json` with the title, caption, hashtags and transcript.
  53. **From this stream frame** (IShowSpeed playing GTA 6, his webcam on the left):
  54. <p align="center">
  55. <img src="docs/demo-stream.jpg" alt="Input: a 16:9 stream with a webcam overlay" width="640">
  56. </p>
  57. **ZClipper renders** the 9:16 split, the 9:16 crop for streams without a webcam, and the thumbnail:
  58. <p align="center">
  59. <img src="docs/demo-outputs.jpg" alt="Outputs: 9:16 split with captions, 9:16 crop with a title bar, thumbnail" width="640">
  60. </p>
  61. **Or 16:9 on request**, with the same captions:
  62. <p align="center">
  63. <img src="docs/demo-16x9.jpg" alt="Output: 16:9 with captions and a title bar" width="640">
  64. </p>
  65. ## Installation
  66. ### Requirements
  67. - Python 3.10 or newer
  68. - [ffmpeg](https://ffmpeg.org) on PATH: `winget install Gyan.FFmpeg` (Windows), `brew install ffmpeg` (macOS), `sudo apt install ffmpeg` (Linux)
  69. - The Python packages:
  70. ```bash
  71. pip install -U yt-dlp pydantic curl_cffi
  72. ```
  73. - Optional, for videos and live clips without captions (local speech-to-text):
  74. ```bash
  75. pip install faster-whisper numpy
  76. ```
  77. ### Claude Code
  78. Pick one.
  79. **Skills CLI**
  80. ```bash
  81. npx skills add misterzaidxpy/zclipper -a claude-code
  82. ```
  83. **Plugin marketplace** (updates arrive with new versions)
  84. ```
  85. /plugin marketplace add misterzaidxpy/zclipper
  86. /plugin install zclipper@zclipper
  87. ```
  88. **Ask Claude to install it**
  89. > Install the ZClipper skill from https://github.com/misterzaidxpy/zclipper: clone the repository and copy its `skills/zclipper` folder to `~/.claude/skills/zclipper`.
  90. Restart Claude Code, then ask **"run the ZClipper doctor"** to check that everything is in place.
  91. ## Usage
  92. Just ask. Some examples:
  93. ```
  94. Clip me 5 GTA 6 best moments
  95. ```
  96. ```
  97. Give me the best moments from IShowSpeed's livestream
  98. ```
  99. ```
  100. 3 clips from https://www.youtube.com/watch?v=..., square format
  101. ```
  102. ```
  103. Watch kaicenat on Twitch for an hour and clip the chat spikes
  104. ```
  105. ```
  106. Make clips from this VOD for my Vyro campaign, facecam on top
  107. ```
  108. What to expect:
  109. | You ask for | ZClipper does |
  110. |---|---|
  111. | A topic or game | Clips the most viewed long videos about it from this week, at most two clips per video |
  112. | A streamer who is live on Twitch or Kick | Renders the most viewed clips viewers made of the current stream |
  113. | A streamer who is live on YouTube | Watches chat for 30 minutes (or as long as you say) and clips every burst |
  114. | A streamer who is offline | Clips their latest finished stream |
  115. | A video URL | Clips that video |
  116. Defaults: 3 clips, 9:16, facecam on top. Say otherwise and it follows.
  117. ## What's inside
  118. ```
  119. zclipper/
  120. ├── .claude-plugin/
  121. │ ├── plugin.json # plugin manifest
  122. │ └── marketplace.json # lets /plugin marketplace add find it
  123. ├── skills/zclipper/
  124. │ ├── SKILL.md # what Claude reads: the recipes, how to pick moments, the reply
  125. │ └── scripts/
  126. │ ├── zclipper.py # command line, JSON out
  127. │ └── zc/
  128. │ ├── find.py # topic search, where a streamer is live
  129. │ ├── moments.py # replay graph, caption bursts, cutting at pauses
  130. │ ├── live.py # YouTube, Twitch and Kick live checks, chat, replay cuts
  131. │ ├── render.py # ffmpeg layouts, captions, thumbnails
  132. │ ├── clips.py # the pipelines that tie it together
  133. │ └── whisper.py # local speech-to-text
  134. └── tests/
  135. ```
  136. The `skills/zclipper` folder is the whole skill. Copy it into `~/.claude/skills/` and it works without the plugin wrapper.
  137. ## Commands
  138. Claude runs these for you; they are listed for debugging and for using ZClipper without Claude. Every command prints JSON.
  139. | Command | What it does |
  140. |---|---|
  141. | `zclipper.py doctor` | Checks Python, ffmpeg and the packages |
  142. | `zclipper.py find "GTA 6" --count 5` | Most viewed recent videos on a topic |
  143. | `zclipper.py find --streamer ishowspeed` | Where a streamer is live, and their latest streams |
  144. | `zclipper.py moments <url>` | Candidate moments with what was said |
  145. | `zclipper.py frame <url> --at 120` | One frame, to find the facecam |
  146. | `zclipper.py make picks.json` | Renders the picked moments |
  147. | `zclipper.py live <platform> <channel>` | Clips chat bursts on a live stream |
  148. | `zclipper.py viewer-clips <platform> <channel> --make 3` | Renders the top viewer clips (Twitch, Kick) |
  149. | `zclipper.py transcript <file>` | Word-timed transcript with local Whisper |
  150. Useful options: `--aspect 9:16|4:5|1:1|16:9`, `--layout split|crop`, `--facecam x,y,w,h`, `--out <folder>`. Set `ZCLIPPER_HOME` to keep Whisper models and temporary files on a roomier drive.
  151. ## Limits
  152. - **YouTube live:** YouTube gives nothing to rank the part of a stream that already happened, so live YouTube clipping starts from the moment you ask.
  153. - **Replays off:** Twitch and Kick streamers who turn replays off cannot be cut after the fact.
  154. - **Chat bursts** find loud moments, not always good ones. A raid or a giveaway can set one off, which is why Claude checks the clips.
  155. - **Platform terms:** clip content you have the right to use, such as a campaign that pays for clips of that creator.
  156. ## Updating
  157. - Plugin: `/plugin marketplace update zclipper`
  158. - Skills CLI: run `npx skills add misterzaidxpy/zclipper -a claude-code` again
  159. ## Contributing
  160. Issues and pull requests are welcome. Run the tests before opening a PR:
  161. ```bash
  162. pip install pytest
  163. python -m pytest
  164. ```
  165. To try your changes in Claude Code without installing:
  166. ```bash
  167. claude --plugin-dir /path/to/zclipper
  168. ```
  169. ## License
  170. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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