Communitygithub.com

AlemTuzlak/skills

Utilisez cette compétence lorsque vous souhaitez transformer un enregistrement brut (tête parlante ou capture d'écran) en une vidéo finale, montée et annotée, avec un ensemble complet de contenu. Elle supprime les silences, signale les erreurs à couper, transcrit, ajoute des superpositions synchronisées avec la transcription (code, surlignages d'écran, mots-clés, listes, comparaisons, diagrammes, étiquettes de section, zoom), effectue le rendu avec l'audio original, puis génère du contenu pour blog, réseaux sociaux et YouTube. Se déclenche sur les commandes : "produire une vidéo", "monter ma vidéo", "annoter mon enregistrement", "/produce-video".

Qu'est-ce que skills ?

Cette compétence (skill) pour agents IA permet de transformer un enregistrement brut (tête parlante ou capture d'écran) en une vidéo professionnelle montée, annotée, et accompagnée de tout le contenu associé (YouTube, blog, réseaux sociaux). Elle est conçue pour les développeurs et créateurs de contenu qui utilisent des agents comme Claude Code, Cursor ou Codex. Le processus automatisé comprend la suppression des silences, la détection et le marquage visuel des erreurs ou moments à couper, la transcription du fichier monté, l'ajout de superpositions synchronisées (code, surlignages de mots, listes, diagrammes, zooms), et le rendu final en haute qualité (CRF 12). Une étape de génération de contenu éditorial (titres YouTube, descriptions, articles de blog, posts sociaux) est déléguée à des compétences spécialisées. Les points clés sont : la qualité non-négociable (pas de ré-encodage destructeur), des portes d'approbation obligatoires (revue visuelle des erreurs, approbation du plan de superpositions, rendu sur commande explicite), et le respect strict de principes de composition visuelle via des skills dédiées (hyperframes, gsap).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/produce-video

Demander à votre IA préférée

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

Documentation

Produire une Vidéo

Prenez un enregistrement fourni par l'utilisateur et transformez-le en une vidéo finale. L'enregistrement est la colonne vertébrale et pilote la chronologie ; cette compétence édite (silence + erreurs/rythme choisis) et augmente (superpositions), puis effectue le rendu et génère le contenu de lancement. Elle NE crée PAS une vidéo synthétique — pour les promos synthétiques pilotées par RP, utilisez hyperframes-video à la place.

Principe de qualité (non-négociable) : chaque étape vidéo préserve la qualité originale. Ne laissez jamais un outil ré-encoder la vidéo en basse qualité. La suppression des silences et les coupes sont effectuées avec un CRF 12 quasi-sans perte à partir de l'original (auto-editor est utilisé UNIQUEMENT pour DÉTECTER le silence, jamais pour encoder — son encodage par défaut écrase la vidéo à ~0,6 Mbps), et le rendu final se fait en CRF 12. Le CRF produit des fichiers petits pour les screencasts statiques ; c'est de la pleine qualité, pas de la perte.

Relation avec les autres compétences (déléguez, ne recréez pas)

  • /transcribe-video — toute la transcription (retourne transcript.words.json au niveau du mot). Invoquez-la ; ne transcrivez pas manuellement.
  • hyperframes — règles de création de composition (Porte d'Identité Visuelle, Mise en Page Avant Animation, contrat de chronologie, superposition vidéo/overlay). Invoquez avant d'écrire/monter tout HTML de composition.
  • hyperframes-cli — chaque commande npx hyperframes (init, lint, inspect, preview, render).
  • gsap — motifs de chronologie/d'accélération GSAP pour les superpositions.
  • youtube-copy — titre/description/tags/chapitres YouTube (P6).
  • blog-post — l'article de blog (P6).
  • social-copy — contenu X/Bluesky/LinkedIn/Reddit (P6).

Ressources fournies

  • scripts/desilence.mjs — suppression des silences par auto-editor + durée avant/après.
  • scripts/extract-frame.mjs — capture d'une seule image (détection du cadrage + surlignage à l'écran).
  • scripts/bake-cuts.mjs — outil de coupe par trim/concat ffmpeg (images clés denses) utilisé en P2.
  • templates/overlays/*.html — 9 modèles de sous-compositions de superposition (remplis par instance ; les sous-compositions sont des documents HTML autonomes dans le CLI installé — lisez le commentaire d'en-tête de chaque fichier).
  • templates/project/{DESIGN.md,styles.css} — Porte d'Identité Visuelle + jetons de marque var(--brand-*) consommés par les superpositions.
  • references/ — mistake-detection.md, overlay-triggers.md, framing-safe-zones.md, frame-analysis.md.
  • La génération de contenu P6 est déléguée aux compétences youtube-copy, blog-post et social-copy (pas de script LLM internalisé).

Portes (non-négociables)

  1. La révision des erreurs P2 est VISUELLE, jamais en terminal — dès qu'il y a ≥1 drapeau, l'agent CONSTRUIT TOUJOURS l'aperçu des marqueurs hyperframes (marqueurs sur la vidéo à chaque intervalle signalé) et le lance, afin que l'utilisateur décide en regardant. NE présentez PAS les drapeaux sous forme de tableau/ question dans le terminal pour que l'utilisateur décide, et NE rendez pas l'aperçu optionnel ou ne demandez pas "voulez-vous que je vous le montre ?" — construisez-le simplement et ouvrez-le. Un court résumé terminal des drapeaux est acceptable, mais la surface de décision est l'aperçu. N'appliquez jamais automatiquement une coupe/accélération.
  2. Approbation du plan de superpositions P4 — présentez le tableau chronologique des superpositions ; pas de construction sans approbation.
  3. L'aperçu est toujours lancé par l'agent — pour la révision P2 et la révision P5, l'agent lance npx hyperframes preview et ouvre l'onglet du navigateur lui-même. NE demandez JAMAIS à l'utilisateur d'exécuter l'aperçu ou d'ouvrir une URL, et NE remplacez JAMAIS un aperçu en direct par un résumé uniquement textuel.
  4. BARRIÈRE ABSOLUE pour le rendu explicite — le rendu s'effectue UNIQUEMENT sur commande explicite de l'utilisateur ("rendu", "envoie"). Après un rendu, les demandes de modification reviennent dans la boucle d'aperçu et NE refont PAS le rendu jusqu'à ce que l'utilisateur le redemande explicitement. Chaque rendu nécessite sa propre commande fraîche. Cela annule toute formulation du type "utiliser des valeurs par défaut raisonnables / non interactif / envoie-le".

"Utiliser des valeurs par défaut raisonnables" / "ne pas poser de questions" saute les questions de configuration (P0) et l'itération de demande — cela NE saute JAMAIS les portes d'approbation, l'aperçu lancé par l'agent ou la barrière de rendu explicite.

Processus

Pré-vol — vérifier les dépendances et les compétences (à exécuter EN PREMIER, avant P0)

Vérifiez l'environnement avant tout travail ; avertissez l'utilisateur de tout élément manquant et de la façon de le corriger.

  • auto-editor (requis pour la P1 suppression des silences) : exécutez auto-editor --version. S'il n'est pas installé, ARRÊTEZ-VOUS et dites à l'utilisateur : "auto-editor n'est pas installé - installez-le avec pipx install auto-editor (ou pip install auto-editor), puis ré-exécutez." Ne tentez pas la P1 sans lui.
  • ffmpeg / ffprobe (OBLIGATOIRE — P2 coupes, P4 analyse d'image, P5 rendu, audio) : exécutez ffmpeg -version. S'il manque, ARRÊTEZ-VOUS et dites à l'utilisateur d'installer ffmpeg et de l'ajouter au PATH. Le pipeline ne peut pas fonctionner sans lui.
  • Docker (pour /transcribe-video) : docker info. Avertissez si le démon est arrêté (démarrez Docker Desktop).
  • Node >= 22 : node --version. Avertissez si plus ancien.
  • Compétences requises — confirmez qu'elles sont disponibles (essayez d'invoquer / vérifiez la liste des compétences) ; avertissez pour toute compétence manquante et quelle phase elle bloque :
    • transcribe-video (P2/P3 transcription), hyperframes + hyperframes-cli + gsap (P2/P4/P5 composition et rendu), youtube-copy + social-copy (P6). blog-post uniquement si l'utilisateur opte pour un blog (P6, optionnel).
  • Résumez le résultat du pré-vol en un court bloc (ce qui est présent, ce qui manque). Ne passez outre une dépendance/compétence requise manquante que si l'utilisateur dit explicitement de continuer sans elle (et notez le résultat dégradé).

P0 — Entrée et configuration

  • Entrée : chemin vers l'enregistrement brut (obligatoire).
  • Optionnel : un dépôt/fichiers pour un ancrage réel du code ; style visuel/marque (sinon exécutez la Porte d'Identité Visuelle hyperframes — détectez depuis le dépôt, sinon posez 3 questions de style ; écrivez templates/project/DESIGN.md + valeurs de marque dans styles.css). Densité des superpositions (clairsemée / équilibrée / riche).
  • Dossier de sortie unique (<OUT>) : tout ce que cette compétence produit vit dans UN dossier, par défaut <recording-dir>/<video-slug>-produced/ (remplaçable par un chemin fourni par l'utilisateur). Créez-le maintenant. Structure finale :
    <OUT>/
      final.mp4                 # vidéo rendue (P5)
      hyperframes/              # projet HyperFrames : index.html, styles.css, DESIGN.md, compositions/, renders/ (P4–P5)
      transcript.txt            # transcription finale éditée (P3 / P6)
      transcript.srt
      transcript.words.json
      youtube.md                # P6
      socials.md                # P6
      blog.md                   # P6
      .work/                    # fichiers intermédiaires : 01_desilenced.mp4, 02_edit_N.mp4, frames/ (supprimables en P7)
    
    Toutes les phases suivantes écrivent dans <OUT> — ne dispersez jamais les sorties ailleurs. <work> ci-dessous = <OUT>/.work.

P1 — Suppression des silences (sans perte)

node scripts/desilence.mjs <input> --out <work>/01_desilenced.mp4 --margin 0.3s

desilence.mjs utilise auto-editor UNIQUEMENT pour détecter les plages silencieuses (--export v3), puis coupe l'ORIGINAL avec ffmpeg en CRF 12 quasi-sans perte, en conservant l'audio original. Ne laissez PAS auto-editor encoder la sortie — son ré-encodage par défaut écrase la vidéo à ~0,6 Mbps et la brouille en permanence (les visages surtout) ; aucun débit aval ne peut récupérer cela. Signalez la durée avant/après et les secondes supprimées. Cela devient la copie de travail.

P2 — Boucle de révision des erreurs et du rythme (porte d'approbation)

  1. Transcrivez la copie de travail : invoquez /transcribe-video sur <work>/01_desilenced.mp4 avec --out <work> → transcription de travail (intermédiaire ; remplacée par la transcription finale de P3).
  2. Détectez les drapeaux selon references/mistake-detection.md (coupes + accélérations), alignés sur les limites des mots.
  3. Toujours (dès qu'il y a ≥1 drapeau) construisez la révision visuelle. Échafaudez un projet hyperframes léger avec la vidéo désilencée comme piste de base ; placez des marqueurs temporaires VISUELLEMENT DISTINCTS SUR LA VIDÉO à chaque intervalle signalé (coupe = barre rouge, accélération = avance rapide ambre, chacun étiqueté avec l'extrait + son index). L'agent lance npx hyperframes preview et ouvre le navigateur lui-même (selon references/framing-safe-zones.md). C'est la surface de décision — ne la remplacez jamais par un tableau terminal. Une note terminale d'une ligne ("3 drapeaux marqués dans l'aperçu — examinez et dites-moi lesquels couper/accélérer/conserver") est le maximum que le terminal doit afficher.
  4. L'utilisateur regarde l'aperçu marqué et choisit par intervalle : couper / accélérer (facteur, par défaut ~1,5–2×) / laisser / ajouter ses propres plages.
  5. Appliquez les sélections → <work>/02_edit_N.mp4, puis re-prévisualisez :
    • Coupes : utilisez node scripts/bake-cuts.mjs <input> --out <work>/02_edit_N.mp4 --cut s,e --cut s,e … (trim/concat ffmpeg en CRF 12 quasi-sans perte par défaut — coupe vidéo+audio à l'identique en un seul passage). N'utilisez PAS auto-editor --cut-out pour les coupes d'erreurs — son argument variadique attribue mal la dernière plage comme entrée positionnelle, il ré-encode avec perte, et une approche par filtre select désynchronise l'audio.
    • Accélérations : auto-editor --set-speed-for-range vitesse,s,e (préservation de la hauteur tonale) ; passez UNE plage par invocation, ou placez --set-speed-for-range en dernier sur la ligne de commande, pour éviter le même piège d'argument variadique.
    • Tous les horodatages de coupe/accélération sont sur la chronologie désilencée (la transcription d'où proviennent les drapeaux). Appliquez coupes et accélérations dans le même tour sur cette chronologie.
  6. Bouclez jusqu'à ce que l'utilisateur dise "terminé". Protection contre la dérive : après ~10 tours, proposez de réinitialiser à un intermédiaire antérieur. Artefact final : <work>/final_cut.mp4.

Les coupes et accélérations sont intégrées à la vidéo ICI (avant P3) afin que les horodatages des mots de la transcription finale correspondent à la chronologie éditée.

P3 — Transcription finale

Invoquez /transcribe-video sur <work>/final_cut.mp4 avec --out <OUT> afin que transcript.txt / transcript.srt / transcript.words.json atterrissent en haut du dossier de sortie. Cette transcription avec horodatages de mots est la source de synchronisation pour toutes les superpositions (P4) et l'entrée pour la génération de contenu (P6).

P4 — Conception et construction des superpositions (porte d'approbation)

  1. Détection du cadrage (references/framing-safe-zones.md) : échantillonnez les images avec extract-frame.mjs, classifiez les phases, confirmez les phases + zones de sécurité avec l'utilisateur.
  2. Détection des déclencheurs de superposition (references/overlay-triggers.md) : analysez la transcription avec horodatages de mots → lignes du plan de superposition {start, est_duration, type, content, safe_zone, why}. Pour le code à l'écran, utilisez references/frame-analysis.md (extrayez l'image → localisez → boîte normalisée → garde de stabilité). Pour les cartes de code, dépôt-si-disponible-sinon-synthétisez (signalez synthétisé).
  3. Passage d'auto-amélioration (≥2 itérations) : respectez la densité, appliquez les écarts minimaux + durées minimales, validez chaque superposition par rapport à la zone de sécurité de la phase active.
  4. Porte d'approbation : présentez le tableau chronologique ; l'utilisateur édite/supprime/retarde/ajoute. Le code synthétisé est affiché pour vérification. Pas de construction sans approbation.
  5. Construction (invoquez hyperframes + gsap d'abord) :
    • npx hyperframes init <OUT>/hyperframes --video <OUT>/.work/final_cut.mp4 (le projet vit dans <OUT>/hyperframes ; base : piste vidéo 0 muted playsinline ; audio sur une piste séparée au volume 1 pour que la voix soit entendue). Lisez le index.html généré pour apprendre la syntaxe d'inclusion de sous-composition de cette version du CLI.
    • Copiez templates/project/styles.css (avec les valeurs de marque confirmées) dans <OUT>/hyperframes.
    • Pour chaque ligne approuvée : instanciez le templates/overlays/*.html correspondant, donnez-lui un identifiant de composition unique + data-composition-id, remplissez ses {{jetons}}, définissez data-start = l'horodatage de la transcription et data-duration = la durée de maintien, montez-le au-dessus de la vidéo. Les zooms avant (punch-in) mettent à l'échelle le div ENVELOPPE de la vidéo (jamais la <video>).
    • Les dimensions de sortie héritent de l'enregistrement source.
    • Lisibilité (non-négociable) : tout texte des superpositions doit être clairement lisible sur TOUT fond vidéo. Chaque groupe de texte repose sur un panneau sombre quasi opaque (rgba(8,10,14,0.92), arrondi, bord/ombre subtils) ; les titres/corps sont blancs (var(--brand-text)), le secondaire/accroche/méta sont en ardoise claire (#CBD5E1). N'utilisez JAMAIS var(--brand-accent)/var(--brand-primary) pour le corps/le sous-titre/le texte d'accroche — l'accent est réservé aux barres, bordures, balayages de marqueur, icônes et grands mots d'affichage uniquement (et seulement lorsqu'ils passent ~4,5:1 sur le panneau). En cas de doute, rendez le texte blanc. npx hyperframes validate (contraste WCAG) doit passer sans aucun avertissement de contraste.

P5 — Aperçu et rendu (aperçu obligatoire lancé par l'agent + barrière de rendu explicite)

  • npx hyperframes lint + npx hyperframes inspect (débordement + zones de sécurité) + npx hyperframes validate (contraste). Corrigez jusqu'à ce que ce soit propre.
  • L'agent lance npx hyperframes preview et ouvre le navigateur. Boucle d'itération libre sur les superpositions.
  • Audits pré-rendu : chaque superposition dans la zone de sécurité de sa phase ; durées minimales ; pas de chevauchement de deux superpositions sur la même région simultanément ; lint/inspect/validate propres.
  • Uniquement sur commande explicite de rendu de l'utilisateur : effectuez le rendu en CRF 12 quasi-sans perte. La qualité par défaut standard encode à ~1,4 Mbps et écrase visiblement la vidéo ; passez toujours un CRF bas :
    npx hyperframes render --output <OUT>/final.mp4 --crf 12
    
    (exécuté depuis <OUT>/hyperframes. CRF 12 est quasi-sans perte ; n'utilisez PAS --video-bitrate en espérant un gros fichier — pour les screencasts statiques, CRF produit un petit fichier en pleine qualité, et c'est correct, pas une basse qualité.) Le mp4 final conserve l'audio original. Après le rendu, les modifications ultérieures reviennent dans la boucle et nécessitent une nouvelle commande de rendu explicite.
  • Note qualité : la capture Chrome est une capture d'écran 1:1 sans perte (vérifié : entrée du rendu == sortie pour le texte et les visages), donc un rendu à faible CRF préserve la vidéo donnée. La SEULE chose qui détruit la qualité est une étape amont avec perte — c'est pourquoi la P1 suppression des silences et les P2 coupes s'effectuent toutes deux en CRF 12 quasi-sans perte à partir de l'original. N'ajoutez pas de passes de ré-encodage supplémentaires. Pour une vidéo absolument sans génération, un chemin avancé consiste à effectuer le rendu des superpositions seules dans un --format webm/mov transparent et à les composer par ffmpeg sur la vidéo coupée (le zoom avant est alors appliqué via ffmpeg) — rarement nécessaire.

P6 — Génération de contenu (déléguée à des compétences spécialisées)

Générez le contenu de lancement en invoquant les compétences dédiées, chacune sur la transcription finale éditée (P3 — passez le transcript.srt horodaté pour que les chapitres YouTube aient des heures précises), en écrivant chaque sortie dans <OUT> :

  • youtube-copy → <OUT>/youtube.md (titre, description, balises, chapitres, miniatures — contenu complet pour la publication YouTube).
  • blog-post → <OUT>/blog.md (article de blog complet avec extraits de code, images et métadonnées — uniquement si l'utilisateur a choisi un blog).
  • social-copy → <OUT>/socials.md (publications X/Bluesky/LinkedIn/Reddit, chacune adaptée à la plateforme).

Important : NE GÉNÉREZ PAS le texte P6 vous-même — invoquez les compétences. Chaque compétence connaît son format, sa longueur et sa voix.

P7 — Nettoyage et livraison

  • Supprimez transcript.words.json intermédiaire du .work/ s'il existe (le transcript.words.json final dans <OUT> est la vérité).
  • Confirmez que les 4 artefacts de contenu sont présents (youtube.md, socials.md, et éventuellement blog.md).
  • Résumé de livraison : un tableau avec le chemin de chaque artefact, sa taille et ce qu'il contient.
  • Demandez à l'utilisateur s'il souhaite supprimer le dossier .work/ (récupère généralement 50 à 80 % de l'espace intermédiaire).

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Skills associés