Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/sugatoray/aiskills --skill dynamic-promo-videoAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Dynamic promo video (HTML scenes + voiceover + music)
Produces a 1280x720, ~25-45s MP4: animated scenes in one HTML page, rendered frame by frame with Playwright, encoded with ffmpeg, narrated with a TTS voice (e.g. ElevenLabs), with ducked background music.
SKILL_DIR below means this skill's folder. Only the template is copied into the work folder; the scripts run from SKILL_DIR/scripts/ (each has --help). Needs Node + Playwright/Chromium (preinstalled in cloud sessions; do not reinstall), ffmpeg/ffprobe, Python 3 with numpy.
| Step | Use |
|---|---|
| Scenes | assets/template/index.html · details: references/scene-engine.md |
| Real page screenshots | references/screenshots.md |
| Voiceover | references/voiceover.md · scripts/tts_elevenlabs.py, scripts/timing.py |
| Render + encode | scripts/render.js |
| Music, mix | scripts/music.py, scripts/mix.py · references/music-and-mix.md |
| Check | scripts/verify.py |
Inputs
| Flag | Meaning |
|---|---|
--demo, --demo=default | Build the default demo instead of a real project: a placeholder video, then how to make one with this skill; see Demo below. |
--demo=self | Build the self demo: the skill explaining itself (what it is, how it works, install, use). |
--voice | Narrate with the default ElevenLabs voice TABZn6CDfjMNGrsnGzzD. |
--voice-elevenlabs=<voice-id> | Narrate with that ElevenLabs voice. A bare --voice-elevenlabs = --voice. |
- Narration uses ElevenLabs only if one route is available, checked in this order:
- the ElevenLabs MCP connector (its
creative_generate_speechtool can be loaded with ToolSearch), or - an API key:
ELEVENLABS_API_KEYis set, or the session's network secrets hold one forapi.elevenlabs.io(then runscripts/tts_elevenlabs.py).
- Real project, no voice flag: narrate with the default voice if a route exists, else music only.
--demo(any variant) without a voice flag: music only. With--voice(or the default voice id), use the variant's bundled clips: no ElevenLabs route is needed and no credits are spent.- A voice flag was given but no route exists: say so, offer to connect the connector, add a key or attach clips; do not silently drop the voice. Never invent a voice id and never fake narration.
- A voice the user names in words is looked up with the connector's voice list; otherwise use the id as given.
Demo (--demo[=default|self])
No research, storyboard or editing. Each variant lives in assets/demo/<variant>/: index.html, narration.txt (one line per scene, - = none) and clips.json, which maps each scene to its approved recording in the shared assets/demo/clips/ (default voice).
- default (48s): scenes 1-6 are the generic template, a placeholder for the viewer's own video; scenes 7-9 show how to make one: a bridge ("that was a placeholder"), the three install routes from
sugatoray/aiskills, get started (music only). The cover is tagged "Demo of Skill /dynamic-promo-video · sugatoray/aiskills". - self (32s): the skill explaining itself: cover, the problem, the scene engine's code, the three install routes, usage, get started.
| Request | Run |
|---|---|
--demo / --demo=default | python3 SKILL_DIR/scripts/demo.py (music only) |
--demo=self | python3 SKILL_DIR/scripts/demo.py --variant self |
add --voice (or the default voice id) | add --voice: the bundled clips, no ElevenLabs route needed, no credits |
add --voice-elevenlabs=<other id>, API key | add --voice-id <id> (generates the clips) |
add --voice-elevenlabs=<other id>, MCP connector | generate one clip per non-- line of the variant's narration.txt (see references/voiceover.md), save as clips/vo<scene>.mp3, add --clips-dir clips/ |
With --voice the result is identical every run (same frames, same audio). Output: promo-demo/demo_final.mp4 and thumbnail.png, checked; deliver as in step 5. The skill icons are simplified drawings.
0. Before building
- Research the subject first: README, package page, marketplace listing, install commands. Use real names, commands and versions. Do not invent features.
- Use the project's real branding (banner, icon, colors, fonts) and real screenshots from its docs where possible. Check the repo for docs images before drawing anything.
- Sandbox network is allowlisted: npm registry, marketplace and github.com web pages are usually blocked from the shell. Git clone of a public repo often works (use the add_repo tool, then clone). If the repo's own CLAUDE.md says to read docs first and the task is not editing the repo, say you are skipping them.
- Make a task list. Last task: check frames and audio, then deliver.
1. Storyboard (write the narration first)
Typical 6 scenes: (1) cover/title, (2) the problem, (3) the product in action, (4) install commands, (5) editor/extension usage, (6) end card with commands and links. The template has exactly these. Write one narration line per scene (about 2.5-3 words per second). Scene length is set by the narration, not the other way round.
2. Build the scenes
Copy SKILL_DIR/assets/template/index.html into the work folder and edit it: brand CSS variables, scene text, real screenshots, camera keyframes. Rules that matter most:
- Everything is a function of
tthroughwindow.setT(t); no CSS animation, no timers. - Frame 0 is a finished cover (social platforms use it as the preview). Scene 1 only fades out.
- Icons are simplified drawings, not official logos; say so unless official files are supplied.
- Do not reuse a class name a script queries with
querySelectorAll.
3. Preview, then voice, then retime
node SKILL_DIR/scripts/render.js index.html --preview 0,6,12,17,23,29 --thumbnail thumbnail.pngLook at the preview frames before going on. Then produce the voice clips with the voice from Inputs (details in references/voiceover.md; one generation per scene, never re-run a paid generation). With an API key:
python3 SKILL_DIR/scripts/tts_elevenlabs.py --script narration.txt --voice <voice-id> --dry-run # check the plan first
python3 SKILL_DIR/scripts/tts_elevenlabs.py --script narration.txt --voice <voice-id>With the MCP connector, call creative_generate_speech once per scene with that voice_id. A scene with no narration gets the line - (no clip; pass - to timing.py). If the voice says a name wrong, write it the way it sounds, test the name alone (about 15 credits) and splice the approved sample into the clip instead of regenerating the line (references/voiceover.md). Then retime:
python3 SKILL_DIR/scripts/timing.py --authored 0,4,9,15,21,26,31 --clips vo0.mp3 vo1.mp3 vo2.mp3 vo3.mp3 vo4.mp3 vo5.mp3Add --write-html index.html to write the new const NB = [...] into the page (or paste the printed line). Scenes stretch to fit; the voice is never sped up.
4. Render, music, mix
node SKILL_DIR/scripts/render.js index.html --encode promo_silent.mp4
python3 SKILL_DIR/scripts/music.py --style energetic --duration <total> --out music.wav
python3 SKILL_DIR/scripts/mix.py --video promo_silent.mp4 --music music.wav --voice 0.3:vo0.mp3 ... --out promo_final.mp4Use a licensed track instead of music.py when the user supplies one; if synthesized, say it is simple and synthesized. Copy the --voice arguments from timing.py's output. If only visuals change later, re-render and run mix.py --audio-from <previous final>.
5. Verify and deliver
python3 SKILL_DIR/scripts/verify.py promo_final.mp4 --frames <one time per scene>- It must report both streams with near-equal durations; read the per-second dB line (voice present, music dipping under it).
- Look at frame 0, one frame per scene and the last frame in
check/. Confirm no overlaps or clipped text. - Say clearly which file has sound: keep the
_silent/_finalnames. - Send with SendUserFile (display render), plus
thumbnail.png. Summarize in a few lines: what each scene shows, what is real vs. drawn, and what you could not verify (you have not listened to the audio). - Offer a LinkedIn/social post note only if asked; keep claims to what the README documents (for example "early development").