Communitygithub.com

josueh04/product-video-skills

Coordonner la construction d'une ou plusieurs vidéos signées du produit actuel avec des sous-agents (reconnaissance des sources, vérité produit, specs UI, voix, un constructeur par vidéo), ré-exécuter le QA soi-même, puis livrer. Un coordinateur léger qui ne construit jamais lui-même. À exécuter uniquement lorsque l'utilisateur tape /video-build.

Qu'est-ce que product-video-skills ?

Ce skill permet à un agent coordinateur de gérer la création de vidéos produit signées en orchestrant des sous-agents spécialisés, sans jamais construire la vidéo lui-même. Il vérifie d'abord les signatures (gate) pour éviter les reworks coûteux, puis dispatche les sous-agents par vagues : reconnaissance des sources, vérité produit, spécifications UI, voix, puis compilation et rendu. Après chaque rendu, l'agent coordinateur effectue son propre QA en vérifiant les fichiers, les planches contact et les extraits, et renvoie les problèmes au constructeur si nécessaire. Il gère le parallélisme entre plusieurs vidéos et peut reprendre une construction interrompue. Le skill est conçu pour fonctionner avec Claude Code et utilise les sous-agents en arrière-plan via l'outil Agent, avec des prompts centralisés dans des fichiers de référence. La livraison finale refuse les brouillons, les rapports échoués ou les fichiers non vérifiés, et le coordinateur produit un rapport de synthèse avec les décisions restantes à prendre par l'utilisateur.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josueh04/product-video-skills/tree/HEAD/skills/video-build

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/video-build

Vous êtes le coordinateur. Vous vérifiez la porte, répartissez les sous-agents étape par étape, vérifiez chaque étape par ses fichiers, réexécutez le QA vous-même, livrez et rapportez. Vous n'écrivez pas de code de composition, de spécifications ou de narration, et vous ne faites pas de rendu.

Pourquoi cette séparation : dans la production d'où viennent ces compétences, alors que l'agent principal construisait lui-même les vidéos, son contexte s'est rempli 8 fois, une fois au milieu d'une correction. Lorsqu'il se contentait de coordonner (consolider, rédiger des briefs, examiner les preuves, livrer), trois corrections ont été livrées en 70 minutes. La coordination est également l'endroit où se trouve la porte de qualité : les sous-agents ont signalé des rendus "propres" que le propre QA du coordinateur a ensuite détectés avec un flash de 0,3 s et une modale coupée.

0. Trouver le travail

PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"; S="$PVS_HOME/skills/video-build/scripts"   # entre guillemets lors de l'utilisation
  • Avec <video> : videos/<video>/ dans le produit actuel.
  • Sans : le dossier vidéo dans lequel vous vous trouvez, ou sinon chaque vidéo du produit dont les fiches sont signées et dont la version actuelle n'a pas de livraison. Affichez cette liste et confirmez-la en une question fermée avant d'envoyer quoi que ce soit.

Exécutez "$PY" "$S/stages.py" <video_dir> pour chaque vidéo et affichez le tableau. Les étapes déjà terminées sont ignorées, donc /video-build peut reprendre une construction arrêtée à mi-chemin.

1. La porte

"$PY" "$S/stages.py" <video_dir> --require signoff. Si l'une ou l'autre des signatures dans BRIEF.md est vide, arrêtez-vous et dites à l'utilisateur ce qui manque et comment signer (le relecteur écrit son nom ou vous dit d'exécuter sign.py depuis /video-new). C'est le contrôle qui empêche le type de rework le plus coûteux (une fonctionnalité que le relecteur voulait voir expliquée et que personne n'a notée) de démarrer une construction.

--draft est la seule exception, et uniquement lorsque l'utilisateur l'a tapé : un brouillon peut être construit, rendu et vérifié par QA pour que le relecteur voie quelque chose avant de signer, mais deliver.py le refuse. Dites-le dans le rapport.

Lisez également product.yaml, kit/RULES.md, BRIEF.md, COVERAGE.md et CLAIMS.md vous-même : vous en avez besoin pour rédiger les invites des sous-agents et juger leurs résultats. Ne lisez rien d'autre en profondeur.

2. Répartition

Utilisez l'outil Agent avec des sous-agents en arrière-plan. Les invites pour chaque étape se trouvent dans references/stage-prompts.md et l'invite du constructeur est references/builder-prompt.md ; lisez-les avant la première répartition et remplissez chaque espace réservé. Après chaque rapport de sous-agent, exécutez "$PY" "$S/stages.py" <video_dir> --require <stage> avant de commencer tout ce qui en dépend.

VagueÉtapeSous-agentsNécessiteÉcrit
1reconnaissance1 par vidéo, source-reconsignaturesources.lock, SOURCES.md
2vérité1 par vidéo, product-truthreconnaissanceTRUTH.md
2spécifications1 par écran, ui-spec-from-code (ou ui-reference-capture pour les écrans sans code)reconnaissancespecs/<screen>.md
3voix1 par vidéo, script-and-voicevéritéaudio/lines.tsv, clips/, timings.json
4composer + rendu1 constructeur par vidéo, ui-demo-composer + seek-safe-motionspécifications, voixvideo/, renders/<video>-v<N>.mp4
5qavousrenduqa/REPORT.json
6livrervousqadeliveries/

Les vagues s'exécutent en parallèle entre les vidéos et au sein d'une même vague (la vérité et les spécifications de chaque écran partent ensemble). Plusieurs vidéos partagent une même machine : dites dans chaque invite qu'aucun agent ne tue un processus qu'il n'a pas démarré et que les rendus peuvent être plus lents pendant que d'autres s'exécutent.

Avant la vague 3 sur la version 1, si le fournisseur de voix est payant, montrez à l'utilisateur le plan de narration en un message : la table des chapitres, l'accroche, la voix, au plus trois décisions fermées avec des valeurs par défaut. L'enregistrement de la narration consomme un quota partagé, et un ton ou un nom que le relecteur n'aime pas est moins cher à modifier avant l'enregistrement. Si l'utilisateur a déjà dit d'aller droit au but, ignorez cette étape et listez les choix pour veto dans le rapport final à la place.

Pendant que les sous-agents s'exécutent, ne les sollicitez pas avec des messages. Vérifiez la progression via les fichiers (dates de modification, $STAGES, la fin d'un journal de rendu) et répondez à leurs questions lorsqu'ils vous les envoient. Les approbations remontent à l'utilisateur, les décisions redescendent : si un sous-agent demande quelque chose que seul l'utilisateur peut autoriser (un téléchargement, une nouvelle source d'actif), posez une question fermée à l'utilisateur et relayez la réponse.

Si un sous-agent cesse de répondre, démarrez-en un nouveau avec la même invite en ajoutant "l'agent précédent s'est arrêté à <étape> ; continuez à partir des fichiers". L'état réside dans les fichiers, pas dans les agents.

3. Votre propre QA, quoi que le constructeur ait rapporté

"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <mp4> \
  --strip <nom>:<t0>:<t1> ...

Chargez le skill render-qa pour savoir comment lire le résultat. Ajoutez un extrait autour de chaque titre de chapitre, de chaque modale et de l'écran de fin pour verrouiller le transfert (heures issues de la table des chapitres du constructeur). Ensuite, regardez vous-même qa/REPORT.md, chaque planche contact et chaque extrait. Vérifiez la narration par rapport à COVERAGE.md : chaque ligne "oui" doit être expliquée dans son chapitre.

Si quelque chose échoue, renvoyez le problème exact au constructeur (SendMessage tant qu'il est vivant, le format de correction condensé dans references/stage-prompts.md), ou, s'il a disparu, démarrez un réparateur avec l'invite dans $PVS_HOME/skills/video-review/references/fix-prompt.md (lisez le fichier ; n'invoquez pas ce skill, il est invoqué par l'utilisateur). Réexécutez cette étape sur le nouveau rendu. Ne livrez jamais un rendu que vous n'avez pas vous-même vérifié par QA.

4. Livrer

"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <mp4> --archive-previous

Il refuse un brouillon, un rapport échoué ou un rapport dont le sha256 ne correspond pas au fichier. Ne contournez pas un refus : corrigez la cause. Ne jamais écraser un fichier livré ; deliver.py augmente le nom à la place et prévient, et vous le dites.

5. Rapport

Un tableau pour l'ensemble du lot, puis au plus trois décisions fermées :

VidéoVersionDuréeChapitresCouverture expliquéeQALivré en tant que

En dessous : ce qui est réel et ce qui est supposé, tout ce qui n'est pas vérifié, les noms, voix et accroche pour veto, et la prochaine étape (/video-review avec les notes du relecteur). Écrivez dans la langue de l'utilisateur, court, les tableaux en premier.

Quand lire les références

  • references/stage-prompts.md : avant d'envoyer les vagues 1 à 3, et pour toute demande de correction.
  • references/builder-prompt.md : avant d'envoyer la vague 4.

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

josueh04/product-video-skills

Extract, once per product, everything every video of it reuses and write it to kit/ and product.yaml (design tokens, font subsets as woff2, icon subsets as SVG from the product's own icon packages, logos in light, dark and app-tile variants from the repo, a fictional cast proposed once for veto and then frozen, the canonical-names map, pronunciations, banned terms and the read-only tool list). Use it when a product is set up or its kit is missing or incomplete, when a video needs an icon, font or logo that is not in kit/ yet, when someone asks for demo names, fake customers, phone numbers or emails, when a brand word is mispronounced or an old product name shows up, and when checking that demo data is fictional.

josueh04/product-video-skills

Interview the user about a product, then create products/<slug>/ with its own git history, a filled product.yaml and linked skills, fetch its sources and build its kit. Run only when the user types /product-new.

josueh04/product-video-skills

Back every sentence of a video's narration (audio/lines.tsv) and every screen it shows with a citation into the pinned source code (role/path:line@sha) or a docs URL, mark what is visible in the UI versus backend-only, flag restricted or unreleased features, and cut or rewrite anything unbacked; writes the video's TRUTH.md and checks it with truth_check.py. Use it whenever a script or narration is drafted or edited, before voice is generated, before a build, when someone asks "can we say this?", "is this true?", "does the product really do X?", when a reviewer asks for a feature or a claim the product may not support, and when a source document (pitch deck, PRD, marketing page) makes claims the video wants to repeat.

josueh04/product-video-skills

Check a rendered product video before anyone else sees it: worker-pattern flicker, black frames, loudness and true peak, clipping, clicks at clip edges, overlapping narration, speech to text against the script, banned terms and legacy names, camera zoom, contact sheets, frame strips at transitions and parity against the approved version; then write qa/REPORT.json, the only thing deliver.py accepts. Use it after every HyperFrames render, whenever someone asks "is the render clean", "QA this", "check the video", "check the audio", "why does it flicker", "there is a click", "compare v3 with v2", "did the approved part change", or before showing, sending, uploading or delivering any MP4, even when the request does not say QA. Also use it to triage a defect a reviewer reported in a render.

josueh04/product-video-skills

Write a product video's narration and turn it into voice clips with word timings, pronunciation fixes, sound effects and even loudness. The script becomes a table of moments and then audio/lines.tsv (one clip per sentence, with role and speed columns); tts.py voices it with ElevenLabs or the free macOS say voice, maps brand respellings back to the on-screen spelling, normalizes every clip and writes audio/timings.json for the composer; make_sfx.py builds typing tracks from real keystrokes and places recorded click and pop sounds. Use it whenever a video needs a script, narration, voice-over, lines.tsv, timings.json, TTS, a new take, a voice or casting choice, a pronunciation fix ("it says the name wrong"), a changed sentence, a tone note ("too hype", "sounds cut off"), audio levels, a click at the end of a clip, typing or click sounds, or when the build stage asks for the voice. Also use it for silent loops, which still need a moment table and SFX.

josueh04/product-video-skills

The animation rules that keep HyperFrames' parallel render workers from dropping, flashing or flickering elements, plus a static lint (lint_motion.py) that finds the violations in a video's template before it costs a render. Use it whenever you write or edit GSAP tweens, timelines, cursors, camera moves, typing, scrolls or pop-ups in a HyperFrames composition or a video's src/template.tpl, whenever a render shows flicker, stutter, an element that vanishes on some frames, a title that flashes, or a "WORKER PATTERN" line from scan_render.py or qa.py, and whenever the preview looks right but the MP4 does not. Also use it to review someone else's timeline code before rendering.

josueh04/product-video-skills

Pin a product's source code (read-only exports in sources/ plus sources.lock), confirm that the pinned commit is what runs in production, and map every screen of a video brief to its route, components, i18n strings and state, written to the video's SOURCES.md. Use it whenever a video needs to know where a screen lives in the code, when sources/ is missing or stale, before ui-spec-from-code or product-truth start on a video, after the product's frontend changed ("what changed", "which videos are affected", "refresh the sources", "is this checkout current", "which commit is in prod"), and when there is no code and you need an inventory of the no-code references (recordings, recovered captures, docs) a screen can be rebuilt from.

josueh04/product-video-skills

Compose a narrated product demo in HyperFrames: the stage (the product UI rebuilt at its real viewport and scaled to 1080p, camera, rack focus with veil, chapter titles, cursor and clicks, typing, streaming text, pop-ups, toasts, scrolls, end screen and lockup) and the build.py that anchors every beat to a word of the narration. Use it whenever you write or edit a video's video/build.py, src/template.tpl or src/app.css, place a beat on a word, add a chapter, a click, a pop-up or a push-in, frame a screen, build the end screen or lockup, snapshot setup beats, or render a draft or delivery MP4 of a product video in this workbench. Also use it when someone says "the cursor is off", "too zoomed in", "too fast", "it feels chaotic", "the title flashes", "sync the UI to the voice", or asks for a walkthrough, demo or pitch video of a UI.

josueh04/product-video-skills

Gather pixel references for UI that the code cannot show, or to check a rebuild against the real thing, using frames and timed OCR text from screen recordings, captures recovered from past Claude Code session transcripts, a local instance of the app built like production, and web research for third-party apps, plus side-by-side parity images and contact sheets. Use it whenever someone hands over a screen recording (.mov or .mp4) of the product, when a screen has no usable source code (a stale checkout, another company's UI such as a sign-in page, calendar or CRM, runtime output from a backend not in the repos), when asked "what does it really look like", "match the recording", "how long does that animation take in the app", "compare our render to the real app", or when screenshots from an earlier session might already exist. Never uses the reviewer's personal browser.

josueh04/product-video-skills

Turn a product's real frontend code into 1:1 rebuild specs for a video, one read-only subagent per screen, each returning static HTML, CSS with every variable resolved to its literal value and cited (role/path:line@sha), every state, transitions with exact durations and easings, icons from the code's own icon sets, and the exact i18n strings; plus resolve_tokens.py to write the product's design tokens to kit/tokens.css. Use it whenever a screen of the product has to appear in a video, when writing or fixing video/src/app.css or the template markup, when someone asks for exact sizes, colors, fonts, paddings, animations or icons of a screen, when a rebuilt screen "looks off" next to the real app, and when the design tokens or theme of a product need extracting. Framework adapters cover Angular with PrimeNG (proven), React, Vue, Tailwind and plain HTML (unproven).

josueh04/product-video-skills

Say where this session stands in the Product Video Skills workbench (setup state, which product and video the current folder belongs to, the stage of every video) and the exact next command to type. Also answers "how do I..." questions about the workbench from its docs.

josueh04/product-video-skills

Start a new video of the current product - create videos/<video>/, write BRIEF.md, the feature coverage matrix (COVERAGE.md) and the claims sheet (CLAIMS.md), propose chapters, then stop for the reviewer's sign-off. Never builds. Run only when the user types /video-new.

josueh04/product-video-skills

Turn a batch of reviewer feedback on the product's videos into one table per video, fix every video that got notes in parallel (one subagent each) while keeping approved parts, re-run QA and parity, bump versions and deliver. Run only when the user types /video-review.

josueh04/product-video-skills

Check this machine and install the pinned video toolchain of the Product Video Skills workbench (HyperFrames CLI, its rendering Chrome and its agent skills from the same release, the Python environment, the speech model for QA), then run the self-check. Safe to run again. `/video-setup check` only reports.

Skills associés