Skip to content
Back to search

claude-faceless-shorts-creator

A faceless YouTube-Shorts factory driven by Claude Code: pure-TSX Remotion visuals, ElevenLabs voice with word-exact captions, library-first sound design. 12 complete example shorts included.

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/hassancs91--claude-faceless-shorts-creator/badge.svg)](/listings/hassancs91--claude-faceless-shorts-creator)

HTML

<a href="/listings/hassancs91--claude-faceless-shorts-creator"><img src="/api/listings/hassancs91--claude-faceless-shorts-creator/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.

Requirements: [Claude Code](https://claude.com/claude-code) · Node 18+ · Python 3.10+ · `ffmpeg` on PATH · an [ElevenLabs](https://elevenlabs.io) key (voice/SFX/music). For the generative track add a [fal.ai](https://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 &lt;your topic&gt;** · **make an AI video short about &lt;idea&gt;** · > **make a vox-style short about &lt;story&gt;**

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

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

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 · 157 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # claude-faceless-shorts-creator
  2. **A faceless YouTube-Shorts factory you drive with [Claude Code](https://claude.com/claude-code).**
  3. Three production tracks in one repo — you just describe the video, and the right pipeline runs:
  4. | You say… | Track | The pixels |
  5. |---|---|---|
  6. | *"make a short about the ×11 trick"* | **TSX** (`/make-short`) | 100% code — a [Remotion](https://remotion.dev) composition, no footage, no stock |
  7. | *"make an AI video short with blue-man"* | **Generative** (`/make-ai-short`) | a fal video model animating a **locked recurring character** |
  8. | *"make a vox-style short about coffee"* | **Collage** (`/make-vox`) | Vox-documentary paper collage — AI-image layers, die-cuts, a traveling camera |
  9. Every track shares the same backbone: ElevenLabs voice with **word-exact synced captions**,
  10. frame-by-frame QA at phone scale, a reusable self-growing SFX/music library, seamless
  11. frame-0==last-frame loops, and no dated engagement-CTA outros.
  12. ## 📖 Read the guide
  13. I wrote up the whole system on my site, including the six-beat grammar that decides whether a
  14. 40-second short is worth finishing:
  15. **[Make Faceless YouTube Shorts With Claude Code](https://learnwithhasan.com/guide/how-to-make-faceless-youtube-shorts-with-claude-code/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=body)**
  16. Free to read, no login. More build guides at
  17. **[learnwithhasan.com/guides](https://learnwithhasan.com/guides/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=body)**.
  18. ## The example videos (more coming)
  19. **TSX shorts** (`shorts/`) — 12 complete productions; each folder has the script, beats
  20. contract, and SFX cue sheet, and the committed composition renders the exact video:
  21. | # | Niche | Title / hook |
  22. |---|---|---|
  23. | 1 | Chess | The 4-Move Checkmate — Punished |
  24. | 2 | Math | The ×11 Trick |
  25. | 3 | Algorithms | Bubble vs Quick: The Race |
  26. | 4 | Dev tips | `git reflog` undoes any mistake |
  27. | 5 | Probability | Monty Hall, Finally Intuitive |
  28. | 6 | Excel | Excel Reads Your Mind (Flash Fill / Ctrl+E) |
  29. | 7 | Kids story | Little Pip (AI-image storybook, ages 4–6) |
  30. | 8 | Cybersecurity | The URL That Isn't PayPal |
  31. | 9 | Music theory | The 4 Chords In Every Hit |
  32. | 10 | Money math | The 1% Fee That Eats 24% Of Your Retirement |
  33. | 11 | Geography | The Map Lied To You |
  34. | 12 | Physics | Astronauts Aren't Weightless. They're Falling. |
  35. **Generative** (`ai-shorts/blue-man/`) — *The Door*: a clay-render character walking through
  36. doors across worlds, thesis "arrival is a myth". Includes the **locked character sheet**
  37. (`character.json` + reference PNG), the model bake-off records (Seedance vs Kling vs Veo, with
  38. derived per-second costs), and the six generated clips — committed, because video-model pixels
  39. are not reproducible.
  40. **Collage** (`vox-shorts/vox-1-coffee/`) — a Vox-style documentary short on coffee's journey:
  41. generated map/archival/cutout layers (committed), a camera choreographed across scenes, and
  42. `DESIGN.md` — the full visual-language spec of the collage engine.
  43. Rendered videos aren't committed (they're reproducible from the repo); links to published
  44. versions will be added here as they go live.
  45. ## How a short gets made
  46. ```
  47. topic ──▶ script.md + beats.json the beat grammar: HOOK (frame 0 = the thumbnail)
  48. │ → SETUP → QUIZ → REVEAL → TWIST → seamless LOOP
  49. ▼
  50. the visuals TSX composition / video-model clips / collage layers
  51. │ (per track — but always ONE Remotion timeline)
  52. ▼
  53. frame-by-frame QA Claude renders PNGs at phone scale and READS them
  54. │
  55. ▼
  56. gen_voice.py ElevenLabs TTS per line → REAL per-word timestamps
  57. │ → captions highlight on the exact spoken word
  58. ▼
  59. sfx-plan.json + mix_sfx.py library-first sound design, audition mix, your ear
  60. │ is the final gate (optional music bed: mix_music.py)
  61. ▼
  62. <track>/<project>/output/*-sfx.mp4
  63. ```
  64. Five Claude Code **skills** encode the craft:
  65. - **`/make-short`** — the TSX pipeline: hook grammar, no-CTA outros, caption safe areas,
  66. Sequence-local frame math, loop-into-intro endings.
  67. - **`/make-ai-short`** — the generative pipeline and its three iron rules: never regenerate a
  68. locked character from text, state the cost before spending it, loop by end-frame constraint.
  69. - **`/make-vox`** — scene dissection into layers, cheapest-source layer production
  70. (gen_image + rembg cutouts, HTML→PNG, SVG-in-TSX), CollageBoard camera choreography.
  71. - **`/vidtsx-2d-generator`** — the TSX authoring rules that keep Remotion renders from crashing.
  72. - **`/suggest-sfx`** — taste-encoded sound design: function-first cues, layered hero moments,
  73. measured audibility (RMS-diff, not hope), a library that compounds across videos.
  74. `brand.md` is the style contract (palette, type, motion, SFX taste) — swap it for your own
  75. brand and every future short follows it.
  76. ## Quickstart
  77. Requirements: [Claude Code](https://claude.com/claude-code) · Node 18+ · Python 3.10+ ·
  78. `ffmpeg` on PATH · an [ElevenLabs](https://elevenlabs.io) key (voice/SFX/music). For the
  79. generative track add a [fal.ai](https://fal.ai) key; for collage layer production:
  80. `pip install pillow rembg playwright && playwright install chromium` (the only pip installs
  81. in the repo — everything else is stdlib).
  82. ```bash
  83. git clone https://github.com/hassancs91/claude-faceless-shorts-creator
  84. cd claude-faceless-shorts-creator
  85. cp .env.example .env # add your keys
  86. cd remotion && npm install && npm run gen && cd ..
  87. claude # open the repo in Claude Code, then:
  88. ```
  89. > **make a short about &lt;your topic&gt;** · **make an AI video short about &lt;idea&gt;** ·
  90. > **make a vox-style short about &lt;story&gt;**
  91. …or rebuild an example: *"re-render short-5 and regenerate its voice"*.
  92. To just explore the compositions visually: `cd remotion && npm run studio`.
  93. ## Repo layout
  94. ```
  95. .claude/skills/ the five skills (this is where the "editor" lives)
  96. tools/ Python: gen_voice, gen_sfx, gen_music, mix_sfx, mix_music, gen_image,
  97. gen_clip, bakeoff_clip, cutout, capture_web, gen_chords
  98. remotion/ the Remotion project — shared kits in src/lib/ (incl. collage.tsx),
  99. one folder per video in src/shots/
  100. media/library/ reusable assets: SFX clips + music beds (catalogued, loudness-normalized)
  101. media/projects/ media for one specific video — incl. committed AI clips & collage layers
  102. shorts/ the 12 TSX example productions
  103. ai-shorts/ the generative track: blue-man/ (locked character) + IDEAS.md (cost tables)
  104. vox-shorts/ the collage track: vox-1-coffee/ + DESIGN.md (the visual language)
  105. brand.md the style contract — make it yours
  106. IDEAS.md the TSX-shorts niche/idea bank
  107. ```
  108. ## License
  109. MIT — see [LICENSE](LICENSE). Bundled SFX/music clips and example AI media were generated by
  110. the repo author (ElevenLabs / fal / Gemini) and are redistributed here; per-clip provenance is
  111. recorded in `media/library/*/catalog.json` and the per-shot `.json` sidecars.
  112. <!-- lwh-footer -->
  113. ---
  114. ## 📘 The free book
  115. This repo is one thing I built with AI. The book is the system underneath it.
  116. **[Vibe Engineering Blocks](https://learnwithhasan.com/blocks/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=footer)** is my free 74-page book.
  117. 47 building blocks for shipping real apps with AI. One block per page, each with the exact
  118. prompt to hand your AI.
  119. Built by **[Hasan Aboul Hasan](https://learnwithhasan.com/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=footer)**. I build real products with AI and
  120. write down exactly how.
  121. [Guides](https://learnwithhasan.com/guides/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=footer) &nbsp;·&nbsp;
  122. [YouTube](https://www.youtube.com/@HasanAboulHasan) &nbsp;·&nbsp;
  123. [Community](https://learnwithhasan.com/community/?utm_source=github&utm_medium=readme&utm_campaign=claude-faceless-shorts-creator&utm_content=footer)

Ratings and comments

Sign in to rate this skill.

Sign in

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