Communitygithub.com

SingleGrain-Team/video-skills

Construisez un motion design où un enregistrement d'écran est lu dans un grand cadre à côté d'une liste de contrôle, chaque élément de la liste se cochant exactement au moment où l'étape correspondante se produit dans l'enregistrement, pour finir avec tous les éléments cochés et une courte pause.

Qu'est-ce que video-skills ?

Cette compétence permet de créer une vidéo de motion design qui synchronise un enregistrement d'écran avec une liste de contrôle interactive. L'utilisateur fournit un enregistrement (démonstration de produit, tutoriel, onboarding, etc.), des étapes avec des timestamps, un titre et éventuellement une palette de couleurs. En sortie, on obtient un fichier MP4 1920x1080 en H.264 ainsi que le projet HyperFrames éditable. Le résultat final est un film où chaque élément de la checklist se coche exactement au moment où l'étape se déroule dans l'enregistrement, avec une pause finale sur la liste entièrement cochée. Cette compétence est utile pour créer des vidéos de type "regardez les étapes se réaliser" à partir d'une simple capture d'écran et d'une liste d'étapes. Elle prend en charge les palettes de couleurs personnalisées, la validation automatique via des extractions d'images et la génération de projets HyperFrames.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/checklist-overlay

Demander à votre IA préférée

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

Documentation

checklist-overlay

Un enregistrement d'écran à gauche, une liste de contrôle à droite. Chaque élément se coche à l'instant où l'étape correspondante se produit à l'écran. Après le dernier coche, le film se fige sur une liste entièrement cochée.

Entrées

EntréeRemarques
EnregistrementUn fichier vidéo local, idéalement 16:9. Le silence est acceptable.
Étapes3 à 7 éléments : { "label": "...", "at": <secondes dans l'enregistrement> }. Les étiquettes sont de courtes phrases impératives (environ 2 à 4 mots).
TitreUne ligne. Exprimez le résultat ("Intégrez une compétence à votre agent en 5 étapes").
Sous-titreUne ligne optionnelle.
PaletteSurcharges hexadécimales optionnelles : bg, surface, panel, ink, muted, accent, border, accentInk. La valeur par défaut est sombre avec un accent orange. Gardez accentInk assez sombre pour être lisible sur accent.

Si la personne ne fournit pas de timestamps, parcourez l'enregistrement (extrayez des images toutes les 1 à 2 secondes avec ffmpeg, regardez-les) et choisissez la première image où chaque étape est visiblement accomplie ou en cours. Ne devinez pas.

Flux de travail

  1. Chargez /hyperframes, /hyperframes-core, /hyperframes-cli pour le contrat du projet.
  2. Écrivez spec.json :
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "Ouvrir l'application", "at": 1.5 }, { "label": "Rechercher", "at": 7.9 } ] }
    
  3. Générez la composition dans le répertoire du projet : node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2] Cela copie l'enregistrement, extrait la dernière image (afin que l'image se fige après la fin de l'enregistrement) et écrit index.html dimensionné à l'enregistrement. Longueur totale = longueur de l'enregistrement + pause (par défaut 2,2 s).
  4. npx --yes hyperframes check doit réussir avec 0 erreurs et 0 avertissements.
  5. Validez (ci-dessous), puis effectuez le rendu : npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.

Règles de synchronisation

  • Le coche apparaît exactement sur l'étape, jamais avant. Le remplissage et le dessin du coche commencent à t = at ; le dessin se termine environ 0,3 s plus tard. Rien dans l'élément ne doit sembler coché avant at.
  • Les timestamps sont basés sur le temps de l'enregistrement et l'enregistrement commence au temps 0 de la composition, donc at est utilisé tel quel. Si vous coupez l'enregistrement, décalez chaque at de la même quantité.
  • Un contour "à venir" peut apparaître sur l'élément suivant peu après le coche précédent. Il s'agit uniquement d'un contour, jamais d'un remplissage ou d'un coche.
  • Gardez les coche à au moins 1,5 s d'intervalle pour que chacun soit lisible. Si deux étapes sont trop proches, fusionnez-les.
  • Le dernier coche doit se situer au moins 1,5 s avant la fin de l'enregistrement, ou augmentez --hold pour que la liste terminée soit visible pendant 2 s ou plus.
  • Le compteur (n / N), la barre de progression et l'anneau d'image clé pulsent tous en fonction des mêmes valeurs at, restant ainsi synchronisés.

Mise en page (enregistrements 16:9)

Toile 1920x1080, marges de 56 px. Le titre et le sous-titre en haut ; le cadre de l'enregistrement est l'élément principal d'environ 1250 px de large (environ 65 % de la largeur), le panneau de la liste de contrôle est une colonne de 520 px à sa droite, de la même hauteur que le cadre, les éléments se partagent la hauteur de manière égale. Cela permet de garder le texte de l'interface utilisateur dans l'enregistrement lisible. Ne réduisez pas le cadre en dessous d'environ 1100 px de large ; pour un enregistrement plus haut, le générateur met à l'échelle le cadre en fonction du rapport hauteur/largeur. Enregistrements non 16:9 : vérifiez que le cadre tient toujours sous l'en-tête, ou rognez d'abord l'enregistrement.

Les étiquettes s'adaptent sur deux lignes à 32 px ; gardez-les sous environ 26 caractères.

Validation

Effectuez cette opération sur le final.mp4 rendu, pas seulement sur des captures d'écran :

  1. Pour chaque étape, extrayez une image 0,08 s avant at et une 0,45 s après : ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png.
  2. Regardez-les. Avant : élément non coché, compteur à i-1. Après : élément rempli avec un coche, compteur à i, barre de progression avancée.
  3. Extrayez une image dans la pause finale (environ 0,2 s avant la fin) : tous les éléments cochés, compteur N / N, barre pleine.
  4. Vérifiez que le texte de l'enregistrement est lisible dans le cadre et qu'aucune étiquette n'est coupée. Corrigez spec.json ou la palette et régénérez si nécessaire.
  5. ffprobe le fichier : 1920x1080, h264, durée = enregistrement + pause.

Livraison

Signalez le chemin de final.mp4, sa durée et les timestamps des étapes utilisées. Conservez le répertoire du projet (index.html, assets/, spec.json) afin que le film puisse être régénéré avec différentes étiquettes ou palette. Ouvrez d'abord npx hyperframes preview si la personne souhaite éditer dans Studio.

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

Skills associés