About yt-shorts
yt-shorts is a skill for selecting and rewriting self-contained moments from long-video transcripts as YouTube Shorts. It ranks candidate clips and adds opening, screen-text, loop, and framing guidance; publishing remains with the user.
Key features
- 01Finds self-contained 20–55-second segments
- 02Ranks candidates with timecodes and opening lines
- 03Writes a new opening line
- 04Adds on-screen text and a loop point
- 05Notes vertical-crop considerations
- 06Does not publish
Use cases
- 01Selecting Short candidates from a transcript
- 02Rewriting the opening for viewers without context
- 03Planning text and framing for a vertical clip
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/yt-shortsin Claude Code to confirm it loaded.
Details
From the project READMEyt-shorts
A Short cut out of a long video is not a clip of the best moment. It is a moment that survives without the video around it, which is a much smaller set.
Picking
Read the transcript and find spans of 20-55 seconds where all three are true:
- It opens on a complete thought. If the first sentence needs the previous minute, it is not a Short.
- There is a turn in it - a claim, then something that complicates or proves it.
- It ends on a line, not a trail-off.
Rank the candidates and show the user the top five with their timecodes and first line, so they can reject one without reading the whole transcript.
Writing each one
- A NEW first line. The long video's line assumes context this viewer does not have. Write the
replacement and run it through
../yt-script/hookscore.py. - On-screen text for the first two seconds, different words from the spoken line.
- A loop point: what the last line sets up so the first line answers it.
- Vertical framing note - what gets cropped out of a 16:9 frame and whether that matters.
The gate
Nothing here publishes. This skill writes and you publish. Every output ends in a block the user copies, and the last line of every run is the question: ship it, or change it?