claude-faceless-shorts-creator

A faceless YouTube-Shorts factory you drive with Claude Code.
Three production tracks in one repo — you just describe the video, and the right pipeline runs:

Every track shares the same backbone: ElevenLabs voice with word-exact synced captions,
frame-by-frame QA at phone scale, a reusable self-growing SFX/music library, seamless
frame-0==last-frame loops, and no dated engagement-CTA outros.

📖 Read the guide

I wrote up the whole system on my site, including the six-beat grammar that decides whether a
40-second short is worth finishing:
Make Faceless YouTube Shorts With Claude Code

Free to read, no login. More build guides at
learnwithhasan.com/guides.

The example videos (more coming)

TSX shorts (shorts/) — 12 complete productions; each folder has the script, beats
contract, and SFX cue sheet, and the committed composition renders the exact video:

Generative (ai-shorts/blue-man/) — The Door: a clay-render character walking through
doors across worlds, thesis "arrival is a myth". Includes the locked character sheet
(character.json + reference PNG), the model bake-off records (Seedance vs Kling vs Veo, with
derived per-second costs), and the six generated clips — committed, because video-model pixels
are not reproducible.

Collage (vox-shorts/vox-1-coffee/) — a Vox-style documentary short on coffee's journey:
generated map/archival/cutout layers (committed), a camera choreographed across scenes, and
DESIGN.md — the full visual-language spec of the collage engine.

Rendered videos aren't committed (they're reproducible from the repo); links to published
versions will be added here as they go live.

How a short gets made

topic ──▶ script.md + beats.json      the beat grammar: HOOK (frame 0 = the thumbnail)
                │                      → SETUP → QUIZ → REVEAL → TWIST → seamless LOOP
                ▼
        the visuals                    TSX composition / video-model clips / collage layers
                │                      (per track — but always ONE Remotion timeline)
                ▼
        frame-by-frame QA              Claude renders PNGs at phone scale and READS them
                │
                ▼
        gen_voice.py                   ElevenLabs TTS per line → REAL per-word timestamps
                │                      → captions highlight on the exact spoken word
                ▼
        sfx-plan.json + mix_sfx.py     library-first sound design, audition mix, your ear
                │                      is the final gate (optional music bed: mix_music.py)
                ▼
        <track>/<project>/output/*-sfx.mp4

Five Claude Code skills encode the craft:

• /make-short — the TSX pipeline: hook grammar, no-CTA outros, caption safe areas,
  Sequence-local frame math, loop-into-intro endings.
• /make-ai-short — the generative pipeline and its three iron rules: never regenerate a
  locked character from text, state the cost before spending it, loop by end-frame constraint.
• /make-vox — scene dissection into layers, cheapest-source layer production
  (gen_image + rembg cutouts, HTML→PNG, SVG-in-TSX), CollageBoard camera choreography.
• /vidtsx-2d-generator — the TSX authoring rules that keep Remotion renders from crashing.
• /suggest-sfx — taste-encoded sound design: function-first cues, layered hero moments,
  measured audibility (RMS-diff, not hope), a library that compounds across videos.

brand.md is the style contract (palette, type, motion, SFX taste) — swap it for your own
brand and every future short follows it.

Quickstart

Requirements: Claude Code · Node 18+ · Python 3.10+ ·
ffmpeg on PATH · an ElevenLabs key (voice/SFX/music). For the
generative track add a fal.ai key; for collage layer production:
pip install pillow rembg playwright && playwright install chromium (the only pip installs
in the repo — everything else is stdlib).

git clone https://github.com/hassancs91/claude-faceless-shorts-creator
cd claude-faceless-shorts-creator
cp .env.example .env          # add your keys
cd remotion && npm install && npm run gen && cd ..

claude                        # open the repo in Claude Code, then:

make a short about <your topic> · make an AI video short about <idea> ·
make a vox-style short about <story>

…or rebuild an example: "re-render short-5 and regenerate its voice".

To just explore the compositions visually: cd remotion && npm run studio.

Repo layout

.claude/skills/   the five skills (this is where the "editor" lives)
tools/            Python: gen_voice, gen_sfx, gen_music, mix_sfx, mix_music, gen_image,
                  gen_clip, bakeoff_clip, cutout, capture_web, gen_chords
remotion/         the Remotion project — shared kits in src/lib/ (incl. collage.tsx),
                  one folder per video in src/shots/
media/library/    reusable assets: SFX clips + music beds (catalogued, loudness-normalized)
media/projects/   media for one specific video — incl. committed AI clips & collage layers
shorts/           the 12 TSX example productions
ai-shorts/        the generative track: blue-man/ (locked character) + IDEAS.md (cost tables)
vox-shorts/       the collage track: vox-1-coffee/ + DESIGN.md (the visual language)
brand.md          the style contract — make it yours
IDEAS.md          the TSX-shorts niche/idea bank

License

MIT — see LICENSE. Bundled SFX/music clips and example AI media were generated by
the repo author (ElevenLabs / fal / Gemini) and are redistributed here; per-clip provenance is
recorded in media/library/*/catalog.json and the per-shot .json sidecars.

Built by Hasan Aboul Hasan. I build real products with AI and
write down exactly how.

Guides  · 
YouTube  · 
Free book: 47 building blocks for shipping with AI