Skip to content
Back to search

promo-video-studio

MarketplaceWorks with Claude CodeGitHub

Agency-quality promo videos and reels made by Claude: motion graphics, original music and sound design, rendered to MP4.

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/jvilchezz--promo-video-studio/badge.svg)](/listings/jvilchezz--promo-video-studio)

HTML

<a href="/listings/jvilchezz--promo-video-studio"><img src="/api/listings/jvilchezz--promo-video-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<table> <tr><td><b>Claude Code</b><br><sub>terminal · desktop · IDE</sub></td><td>

/plugin marketplace add JVilchezz/promo-video-studio
/plugin install promo-video-studio@promo-video-studio

or in one command (Claude Code ≥ 2.1.275): `/plugin install promo-video-studio --marketplace JVilchezz/promo-video-studio`<br>or from your shell: `claude plugin marketplace add JVilchezz/promo-video-studio && claude plugin install promo-video-studio@promo-video-studio` </td></tr> <tr><td><b>Claude.ai</b><br><sub>web · desktop · mobile</sub></td><td>

1. Download **`promo-video-studio.zip`** from [Releases](../../releases/latest) 2. **Customize → Skills → + → Create skill → Upload a skill** 3. Make sure **Settings → Capabilities → Create and edit files** is on

Or paste this repo's link in a chat and ask: *"Install this skill for me"* — if your Claude can save skills, it shows you a card to save it in one click. </td></tr> <tr><td><b>Any agent</b><br><sub>Claude Code, Cursor, Codex…</sub></td><td>

npx skills add JVilchezz/promo-video-studio

</td></tr> <tr><td><b>Manual</b></td><td>

Copy `plugins/promo-video-studio/skills/promo-video-studio/` into `~/.claude/skills/` (personal) or `.claude/skills/` (project). </td></tr> </table>

**Requirements** (Claude installs them when missing): Python 3.10+, `playwright` + Chromium, `numpy`, `scipy`, `pillow`, `opencv-python-headless`, and `ffmpeg`.

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.

.claude-plugin/marketplace.json · Manifest · 22 lines
  1. {
  2. "name": "promo-video-studio",
  3. "description": "Agency-quality promo videos and reels made by Claude: motion graphics, original music and sound design, rendered to MP4.",
  4. "owner": {
  5. "name": "José Vílchez"
  6. },
  7. "plugins": [
  8. {
  9. "name": "promo-video-studio",
  10. "source": "./plugins/promo-video-studio",
  11. "description": "Promo videos, reels and motion graphics (MP4) for any business, even from zero — brand kit, mascot, music, voice-over and captions.",
  12. "category": "design",
  13. "tags": [
  14. "video",
  15. "motion-graphics",
  16. "reels",
  17. "marketing",
  18. "music"
  19. ]
  20. }
  21. ]
  22. }
README.md · README · 162 lines
  1. <p align="center">
  2. <img src="docs/media/banner.png" alt="Promo Video Studio — an Agent Skill for Claude" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="#-install"><img src="https://img.shields.io/badge/Claude_Code-plugin-D97757?style=for-the-badge" alt="Claude Code plugin"></a>
  6. <a href="#-install"><img src="https://img.shields.io/badge/Claude.ai-skill-1F3480?style=for-the-badge" alt="Claude.ai skill"></a>
  7. <a href="#-install"><img src="https://img.shields.io/badge/npx-skills_add-111111?style=for-the-badge" alt="npx skills"></a>
  8. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-F2C352?style=for-the-badge" alt="MIT"></a>
  9. </p>
  10. <p align="center"><b>Ask Claude for a video. Get an agency-quality MP4 — motion graphics, original music and sound design included.</b><br>
  11. <a href="#-español">Leer en español ↓</a></p>
  12. ---
  13. ## ✨ What it makes
  14. <p align="center">
  15. <img src="docs/media/demo.gif" alt="Demo: portal transition, notification stack and award reveal" width="320">
  16. <br><sub><i>Made from a single prompt — <a href="examples/thank-you-reel">example source</a> · fictional brand · <a href="docs/media/demo.mp4">full video with sound (MP4)</a></i></sub>
  17. </p>
  18. **Promo Video Studio** turns Claude into a senior motion designer, editor and composer. It plans the story on a musical beat grid, builds every scene as animated HTML, renders it frame-by-frame with headless Chromium and scores it with **original, royalty-free music** that hits every cut.
  19. - 🚀 **Starts from zero** — no logo, no colors, no mascot? It asks five quick questions, builds a brand kit (palette, wordmark, app icon) and, if you want one, an original rigged mascot. It **never invents facts**: names, features, prices and numbers come from you, and final renders are blocked while any placeholder is left
  20. - 🧰 **Adapts to what you have** — full brand guide, just a logo, photos, screen recordings, a mascot, real numbers… or nothing. Every element is optional: no mascot, no voice, no music if you don't want them
  21. - 🎬 **Signature transitions** — fly *through* a letter of your logo into the brand reveal (portal), polaroid drops, handwriting reveals, light leaks and film grain
  22. - 🏆 **Hero moments** — cut out an award, medal or product from a phone photo and light it with a golden sweep
  23. - 📱 **App & product promos** — phone mockups playing real screen recordings (auto-cropped, clean status bar, private data blurred), iOS-style notifications, chat conversations
  24. - 🎙️ **Voice-over with ElevenLabs** — script → voice with word timestamps → each phrase placed on its scene → synced captions → music ducks under the voice. No API key? Send any recording and it syncs the captions to your script
  25. - 🧸 **Animated mascots** — splits your mascot into body + arms + legs (automatically, or from layers for any style of mascot) and animates it: wave, point, celebrate, walk in/out, jump, peek, bow, think… It can also **talk and blink**. Exports transparent WebM/WebP for your app's splash and logout screens
  26. - 🎵 **Music & sound design** — original, royalty-free scores in 4 styles from a cue sheet, never shrill, plus SFX (pencil, paper drops, dings, risers, booms, UI sounds) — or an SFX-only track for a licensed song
  27. - 🔔 **Brand sounds** — a family of notification, success, tap and send/receive sounds plus a **sonic logo**, all in one key
  28. - 📊 **Real-data scenes** — count-ups, bar charts, donut rings and stat tiles for presentation closings
  29. - 🗂️ **Every video type** — thank-you & award reels, launch promos, new-version videos, teasers, store-launch announcements, tutorials, presentation openers, data recaps, booth loops, TikTok/Reels shorts, translations
  30. - 🖼️ **Everything around it** — covers, LinkedIn team banners, post captions, GIFs
  31. - 📐 **Every format** — 1080×1920 reels/TikTok/Shorts, 1920×1080 LinkedIn/YouTube, 1080×1350 feed, square
  32. - ✅ **Built-in QA** — a machine check that installs what's missing (`doctor.py`), contact sheets before rendering, a final checklist, and a list of mistakes it will not repeat
  33. <p align="center"><img src="docs/media/gallery.jpg" alt="Frames from the example videos" width="100%"><br>
  34. <sub><i>Frames from the examples: chat opener · data recap · new-version video with mascot and captions (fictional brand)</i></sub></p>
  35. <p align="center"><img src="docs/media/mascot.gif" alt="A mascot split into parts and animated by rig.py" width="240"><br>
  36. <sub><i>One PNG in → body, arms and legs separated → waving, pointing, celebrating</i></sub></p>
  37. ## 🚀 Install
  38. <table>
  39. <tr><td><b>Claude Code</b><br><sub>terminal · desktop · IDE</sub></td><td>
  40. ```text
  41. /plugin marketplace add JVilchezz/promo-video-studio
  42. /plugin install promo-video-studio@promo-video-studio
  43. ```
  44. or in one command (Claude Code ≥ 2.1.275): `/plugin install promo-video-studio --marketplace JVilchezz/promo-video-studio`<br>or from your shell: `claude plugin marketplace add JVilchezz/promo-video-studio && claude plugin install promo-video-studio@promo-video-studio`
  45. </td></tr>
  46. <tr><td><b>Claude.ai</b><br><sub>web · desktop · mobile</sub></td><td>
  47. 1. Download **`promo-video-studio.zip`** from [Releases](../../releases/latest)
  48. 2. **Customize → Skills → + → Create skill → Upload a skill**
  49. 3. Make sure **Settings → Capabilities → Create and edit files** is on
  50. Or paste this repo's link in a chat and ask: *"Install this skill for me"* — if your Claude can save skills, it shows you a card to save it in one click.
  51. </td></tr>
  52. <tr><td><b>Any agent</b><br><sub>Claude Code, Cursor, Codex…</sub></td><td>
  53. ```bash
  54. npx skills add JVilchezz/promo-video-studio
  55. ```
  56. </td></tr>
  57. <tr><td><b>Manual</b></td><td>
  58. Copy `plugins/promo-video-studio/skills/promo-video-studio/` into `~/.claude/skills/` (personal) or `.claude/skills/` (project).
  59. </td></tr>
  60. </table>
  61. **Requirements** (Claude installs them when missing): Python 3.10+, `playwright` + Chromium, `numpy`, `scipy`, `pillow`, `opencv-python-headless`, and `ffmpeg`.
  62. ## 💬 Try it
  63. > Make a 45-second Instagram reel thanking our customers for our first year. Here are 6 photos, our logo and the award we won. Make it emotional but exciting.
  64. > Create a 60-second horizontal LinkedIn video launching our app. Use these screen recordings. No voice-over, professional.
  65. > Turn this into a 20-second TikTok ad with a strong hook. Faster pacing, uplifting music.
  66. > I have a small bakery called Luna and nothing else — no logo, no colors. Make me a 20-second Instagram reel.
  67. > We launched version 2.0 with voice ordering. Make a 30-second reel with a voice-over (here's my ElevenLabs key and voice ID), captions, and our mascot celebrating.
  68. > Here's our mascot PNG. Separate its arms and legs, make it wave, and export it as a transparent animation for our app's splash screen.
  69. > Make an opening for our presentation: a chat about the long line at the cafeteria, then our app's notification. And a closing with our real numbers from this week.
  70. > Create a notification sound and a sonic logo for our app. Give me 4 options.
  71. > The music sounds too sad — make it more exciting. And speed the whole video up a bit.
  72. ## ⚙️ How it works
  73. ```text
  74. brief ─► storyboard on a beat grid ─► video.html (scenes + motion.js) ─► contact-sheet preview ─► fixes
  75. │ assets: photos · cutout.py · make_mask.py · recording.py · rig.py / mascot_talk.py
  76. ├► script ─► voice.py (ElevenLabs + word times) ─► phrases on the timeline ─► captions
  77. └► cue.json ─► score.py (music + SFX + UI sounds + voice ducking) ──────────────┐
  78. render.py (Playwright → ffmpeg) ─► silent.mp4 ──────────────────────────┴► mux ─► QC ─► final.mp4 + cover
  79. ```
  80. | Path | What's inside |
  81. |---|---|
  82. | `…/skills/promo-video-studio/SKILL.md` | workflow, quality bar, toolbox, signature effects |
  83. | `…/reference/` | client brief · video types · design · motion API & recipes · music · voice-over · mascots · sound · deliverables · QA |
  84. | `…/lib/` | `motion.js` (deterministic animation kit: scenes, portal, captions, chat, charts, rays, icons…) · `base.css` |
  85. | `…/scripts/` | `doctor.py` · `brand.py` · `new_project.py` · `render.py` · `score.py` · `mux.py` · `voice.py` · `recording.py` · `rig.py` · `mascot_make.py` · `mascot_talk.py` · `sfx_pack.py` · `make_mask.py` · `cutout.py` |
  86. | `…/templates/` | vertical / horizontal pages · cue sheet · LinkedIn banner |
  87. | `examples/` | five editable examples + `build.sh` |
  88. ## 🎞️ Examples
  89. | | |
  90. |---|---|
  91. | [`thank-you-reel`](examples/thank-you-reel) | 56 s vertical: handwriting hook → polaroids → portal through the logo letter → memories → notification stack + heart → award reveal → thanks → CTA |
  92. | [`chat-story`](examples/chat-story) | 16 s presentation opener: a chat about the long line, typing dots, the app's notification, logo — with send/receive/notification sounds |
  93. | [`data-recap`](examples/data-recap) | 28 s horizontal closing: mascot, count-up with bar chart, stat tiles + donut, "the very first order", logo |
  94. | [`feature-update`](examples/feature-update) | 26 s vertical: "NEW VERSION 2.0", mascot glory moment with rays and sparkles, phone demo with captions, store badges |
  95. | [`mascot`](examples/mascot) | a fictional mascot split into parts with `rig.py` — the source of every mascot animation above |
  96. Render them yourself (needs Python, Playwright and ffmpeg):
  97. ```bash
  98. bash examples/build.sh # all examples
  99. bash examples/build.sh chat-story # just one
  100. ```
  101. ## 🤝 Contributing
  102. Ideas, new effects, new music styles and example videos are welcome — open an issue or a PR.
  103. If this skill made you a video you love, **⭐ star the repo** and share it with `#PromoVideoStudio`.
  104. ## 📄 License
  105. MIT © José Vílchez · Fonts (Anton, Poppins, Caveat) under the SIL Open Font License 1.1 · Generated music is original and free to use commercially.
  106. ---
  107. ## 🇪🇸 Español
  108. **Pedile un video a Claude y recibí un MP4 con calidad de agencia**, con motion graphics, música original y efectos de sonido.
  109. **Instalación**
  110. - **Claude Code:** `/plugin marketplace add JVilchezz/promo-video-studio` y después `/plugin install promo-video-studio@promo-video-studio`
  111. - **Claude en el navegador o la app:** descargá `promo-video-studio.zip` de [Releases](../../releases/latest) y andá a **Customize → Skills → + → Create skill → Upload a skill**. Tené activado **"Create and edit files"**. También podés pegarle el link de este repo a Claude y pedirle *"instalame esta skill"*.
  112. - **Cualquier agente:** `npx skills add JVilchezz/promo-video-studio`
  113. **Sirve para cualquier empresa, aunque empiece de cero:** si no tenés logo ni colores te hace 5 preguntas rápidas, arma el kit de marca y, si querés, una mascota original lista para animar. **Nunca inventa datos**: nombres, funciones, precios y cifras salen de vos. Todo es opcional (mascota, voz, música).
  114. **Qué hace:** planifica la historia sobre el ritmo de la música y anima cada escena con transiciones como el portal a través de la letra del logo, polaroids, escritura a mano, notificaciones, chats, cifras que suben, gráficos y el brillo dorado para premios y productos. Pone **voz con ElevenLabs** (o con cualquier grabación tuya) con subtítulos sincronizados, **separa las partes de tu mascota y la anima** (saluda, señala, celebra, camina, habla y parpadea), compone **música original** sin derechos de autor en 4 estilos, crea **sonidos de notificación y un logo sonoro** para tu app, y hace todo lo de alrededor: portadas, banners de LinkedIn y el texto del post. Sabe hacer reels de agradecimiento, lanzamientos, nuevas versiones, teasers, tutoriales, aperturas y cierres de presentaciones, loops para stands y videos para TikTok. Antes de entregar revisa cada detalle.
  115. **Probalo:**
  116. - *"Haceme un reel de 45 segundos para Instagram agradeciendo a nuestros clientes por el primer año. Acá van las fotos, el logo y el premio. Que sea emotivo pero emocionante."*
  117. - *"Sacamos la versión 2.0. Haceme un video con voz de ElevenLabs, subtítulos y la mascota celebrando."*
  118. - *"Acá está la mascota en PNG: separale los brazos y las piernas y hacé que salude."*

Ratings and comments

Sign in to rate this skill.

Sign in

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