Skip to content
Back to search

video-short

Turn a raw recording into a polished video short with B-roll, motion graphics, captions, and music using your favorite AI agent

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/petergyang--video-short/badge.svg)](/listings/petergyang--video-short)

HTML

<a href="/listings/petergyang--video-short"><img src="/api/listings/petergyang--video-short/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.

To install the skill, just paste this into Claude Code, ChatGPT Desktop, or your favorite agent:

Install the /video-short skill globally from https://github.com/petergyang/video-short

You can also install it with `npx`:

npx skills add petergyang/video-short --skill video-short --global --yes

The first time you run the skill, it'll check if you have the following installed and offer to install what's missing. Plan for around 1 GB of disk space, mostly for the speech model:

- **[ffmpeg](https://ffmpeg.org)** to cut and encode video. - **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** to pull B-roll from YouTube, X, and other sites. - **[Python](https://www.python.org) 3.10 or newer** to run the editing scripts. - **[Node.js](https://nodejs.org) 22 or newer** for [HyperFrames](https://github.com/heygen-com/hyperframes), the free, open-source tool that transcribes your recording on your computer with the [Parakeet](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v3) speech model and renders the edit into video. - **Optional: A Gemini API key** with billing enabled, to generate images with Nano Banana, video clips with Omni Flash, and music with Lyria. Get a key at [Google AI Studio](https://aistudio.google.com/?utm_source=peteryang&utm_medium=partner&utm_campaign=26Q3-peteryang_ais) and set `GEMINI_API_KEY`.

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.

README.md · README · 96 lines
  1. # Video Short
  2. Turn a raw recording into a polished video short, complete with B-roll, motion graphics, captions, music, and more using Claude, ChatGPT, Gemini, or your favorite agent.
  3. https://github.com/user-attachments/assets/51b8decf-d719-4f4b-9824-5686b3a97ac7
  4. [Watch the full tutorial](https://youtu.be/NWll-9p84b4) to see how I use this skill with a real example.
  5. ## Problem
  6. Shorts average 200 billion daily views on YouTube alone, but making a great one by hand still takes hours. And when you ask AI to help, giving feedback in chat is painful because you can't point at the exact frame you want to fix.
  7. ## What video short can do
  8. /video-short makes it easy for you to iterate with AI to create compelling shorts. The best part of the skill is it gives you a review page to give feedback to your AI agent on any frame until the short feels right:
  9. <picture>
  10. <source media="(prefers-color-scheme: dark)" srcset="assets/review-dark.jpg">
  11. <img alt="The review page: the draft short plays on a scene timeline, with comments pinned to frames on the right" src="assets/review-light.jpg">
  12. </picture>
  13. The skill supports making shorts with 4 different layouts:
  14. 1. **A-roll:** You, full screen.
  15. 2. **Punch:** A tighter shot of you for emphasis.
  16. 3. **Split:** A visual on top, you below.
  17. 4. **B-roll:** A visual full screen while you keep talking.
  18. It can also add the following automatically:
  19. - **Captions** that match what you say, word for word.
  20. - **Motion graphics** written in HTML to bring the short to life.
  21. - **B-roll footage** found online that's relevant to what you're saying.
  22. - **AI video and music (optional)** generated with Gemini Omni Flash and Lyria. This step needs a [Gemini API key](https://aistudio.google.com/?utm_source=peteryang&utm_medium=partner&utm_campaign=26Q3-peteryang_ais) with billing enabled. You can also add your own video and music.
  23. ## How to install video short
  24. To install the skill, just paste this into Claude Code, ChatGPT Desktop, or your favorite agent:
  25. ```text
  26. Install the /video-short skill globally from https://github.com/petergyang/video-short
  27. ```
  28. You can also install it with `npx`:
  29. ```sh
  30. npx skills add petergyang/video-short --skill video-short --global --yes
  31. ```
  32. The first time you run the skill, it'll check if you have the following installed and offer to install what's missing. Plan for around 1 GB of disk space, mostly for the speech model:
  33. - **[ffmpeg](https://ffmpeg.org)** to cut and encode video.
  34. - **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** to pull B-roll from YouTube, X, and other sites.
  35. - **[Python](https://www.python.org) 3.10 or newer** to run the editing scripts.
  36. - **[Node.js](https://nodejs.org) 22 or newer** for [HyperFrames](https://github.com/heygen-com/hyperframes), the free, open-source tool that transcribes your recording on your computer with the [Parakeet](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v3) speech model and renders the edit into video.
  37. - **Optional: A Gemini API key** with billing enabled, to generate images with Nano Banana, video clips with Omni Flash, and music with Lyria. Get a key at [Google AI Studio](https://aistudio.google.com/?utm_source=peteryang&utm_medium=partner&utm_campaign=26Q3-peteryang_ais) and set `GEMINI_API_KEY`.
  38. ## How to use video short
  39. I've made this skill as simple as possible to use, just follow these 4 steps:
  40. ![Four steps: install the skill, upload your raw recording, approve the plan, and iterate with feedback](assets/four-steps.jpg)
  41. 1. **Install.** Paste the install prompt above into Claude Code, ChatGPT, or your favorite AI agent. You only do this once.
  42. 2. **Upload.** Record yourself talking, then run the skill and point it at your raw video:
  43. ```text
  44. /video-short edit my video at [path/to/video.mp4]
  45. ```
  46. It'll transcribe the recording and cut retakes, false starts, and dead air.
  47. 3. **Plan.** It researches the topic, finds B-roll from your footage and the web, and shows you a scene-by-scene plan in chat: what's on screen, the words spoken, and anything it wants to generate. Reply "go" or ask for changes.
  48. 4. **Iterate.** Once your agent is done with a draft edit, it'll open the review page for you to play the short, pause on any frame, and leave feedback. The agent will then apply your feedback before reloading the review page with a new version of the short.
  49. Each draft saves a new version and keeps only the one before it, so you can compare the last two, plus a small 720p copy in `renders/share/` to send from your phone or email. The final render replaces every earlier version, and later drafts leave it alone.
  50. ## Make it yours
  51. Fonts, colors, and caption style come from a small `style.json`. Save yours at `~/.config/video-short/style.json` and every short uses it. The keys are in [`reference.md`](skills/video-short/reference.md).
  52. ## What's inside
  53. - [`SKILL.md`](skills/video-short/SKILL.md) contains the editing rules and workflow.
  54. - [`reference.md`](skills/video-short/reference.md) contains the commands, the `edit.md` format, graphics, and style options.
  55. - [`eval.md`](skills/video-short/eval.md) contains the checks the skill runs before handing back a video.
  56. - [`scripts/`](skills/video-short/scripts) contains the scripts for setup, transcription, cutting, generation, rendering, the review page, and QA.
  57. ## Want more great AI skills?
  58. Become a paid member at [Behind the Craft](https://behindthecraft.com) to get all my AI skills, $600+ in AI tool discounts, and my personal AI course.
  59. Subscribe to my [YouTube channel](https://www.youtube.com/@PeterYangYT?sub_confirmation=1) and [newsletter](https://creatoreconomy.so) for practical AI tutorials and interviews.
  60. ## License
  61. MIT. The bundled Inter font is under the [SIL Open Font License](skills/video-short/fonts/OFL.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

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