explaingit

agricidaniel/claude-shorts

Analysis updated 2026-05-18

93PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Claude Code skill that turns long videos into short vertical clips for TikTok, YouTube Shorts, and Instagram, with AI picking the best moments and adding animated captions.

Mindmap

mindmap
  root((repo))
    What it does
      Transcribes video
      Scores segments
      Renders vertical clips
    Tech stack
      Python
      Remotion
      FFmpeg
      faster-whisper
    Use cases
      Podcast clips
      Screen recordings
      Talking head videos
    Audience
      Content creators
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a long podcast or talk recording into several short vertical clips ready for social media.

USE CASE 2

Automatically caption vertical video clips in different visual styles.

USE CASE 3

Extract highlight moments from screen recordings or talking-head videos using AI scoring.

What is it built with?

PythonNode.jsRemotionReactFFmpegfaster-whisper

How does it compare?

agricidaniel/claude-shortsxzf-thu/mega-asrpaddlepaddle/graphnet
Stars939395
LanguagePythonPythonPython
Last pushed2026-05-22
MaintenanceMaintained
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs FFmpeg, Node.js, Python, and Claude Code installed, a GPU is recommended but not required.

No license file mentioned in the README.

In plain English

claude-shorts is a Claude Code skill, a plugin for Anthropic's command-line AI tool, that takes a long video file and automatically extracts short, vertical clips suitable for YouTube Shorts, TikTok, and Instagram Reels. The process is interactive: Claude guides you through each step, presents candidate clips for your approval, and then renders the final output with animated captions. The pipeline works in ten steps. First it validates your input video and checks your system. Then it transcribes the full audio using a GPU-accelerated transcription tool called faster-whisper, which produces word-level timestamps. Next, it detects what type of content is in the video, talking-head footage, screen recordings, or podcasts, because each type is handled differently during the crop-and-reframe step. Claude then reads the full transcript and scores eight to twelve candidate segments using a five-dimension rubric evaluating hook strength, narrative coherence, emotional content, information density, and payoff. You see these candidates in a table with scores and can choose which ones to render, pick a caption style, and select your target platform. The tool then aligns your cut points to natural word boundaries and silences to avoid awkward mid-word cuts, extracts the clips, converts the wide video to vertical 9:16 format, and renders animated captions using Remotion (a React-based video rendering library). Three caption styles are available: bold all-caps with yellow highlights, bouncy colorful text, and clean minimal fade-in. The final export is encoded to the exact specifications each platform prefers. For screen recordings, the cropping dynamically follows the mouse cursor. For talking-head footage, it tracks faces. GPU acceleration is used where available but the tool falls back to CPU. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Use claude-shorts to find the three best clips in my recorded podcast episode and export them for TikTok.
Prompt 2
Set up claude-shorts on my machine with GPU acceleration for faster transcription.
Prompt 3
Explain how claude-shorts scores which video segments are worth turning into a short clip.

Frequently asked questions

What is claude-shorts?

A Claude Code skill that turns long videos into short vertical clips for TikTok, YouTube Shorts, and Instagram, with AI picking the best moments and adding animated captions.

What language is claude-shorts written in?

Mainly Python. The stack also includes Python, Node.js, Remotion.

What license does claude-shorts use?

No license file mentioned in the README.

How hard is claude-shorts to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-shorts for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.