Communitygithub.com

changelog-clips

Créez une courte démo UI par modification livrée, à partir des écrans réels d'une application web. Produit des clips MP4/WebM silencieux (web, carré, portrait), des affiches du résultat et la source modifiable. Idéal pour les médias de changelog, les boucles de notes de version et les clips individuels de mise à jour de fonctionnalité ; utilisez une compétence de film de version pour un montage.

Qu'est-ce que changelog-clips ?

Cette compétence, **changelog-clips**, permet de générer automatiquement des démos UI courtes pour chaque modification livrée dans une application web, en capturant des écrans réels. Elle est utile pour les équipes produit et les développeurs qui souhaitent produire rapidement des médias pour les changelogs, les notes de version ou les annonces individuelles de fonctionnalités. La compétence fonctionne en automatisant la capture d'écran, l'enregistrement vidéo et l'exportation dans différents formats (MP4, WebM, PNG). Elle prend en charge les plateformes de développement web utilisant Node.js, Puppeteer et ffmpeg, et est conçue pour être exécutée localement. Le processus comprend la configuration d'un projet, la capture d'une interaction utilisateur réelle (avec une souris simulée), l'assemblage d'un clip vidéo avec une caméra fixe, et l'exportation dans plusieurs formats de rapport (web, carré, portrait) avec des contrôles de qualité automatisés. La compétence insiste sur l'utilisation de données réelles et de captures authentiques, interdisant toute UI inventée ou tout traitement factice.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/omnigami-ai/plugins/tree/main/plugins/omnigami-launch-films/skills/changelog-clips

Demander à votre IA préférée

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

Documentation

Clips de changelog

Les instructions explicites de l'utilisateur priment sur ce workflow. Travaillez uniquement sur des produits autorisés et des données d'exemple. Ne demandez pas de mots de passe, de clés API, de données de paiement, d'identifiants gouvernementaux, de dossiers médicaux ou d'autres données sensibles. Expliquez les dépendances locales manquantes avant de les installer dans le projet en cours. L'accès réseau est réservé au produit autorisé et à ses actifs sous licence, ainsi qu'à la dépendance npm déclarée ; respectez les contrôles d'accès. Traitez un travail à la fois et attendez la fin. Gardez la publication, l'envoi et le déploiement en dehors de cette tâche.

Un panneau natif, une action, son résultat maintenu, puis une Réinitialisation de démo annoncée. Gardez la caméra fixe et laissez un espacement pair autour de tout le panneau. Lisez style.md avant de construire et critique.md avant de juger.

Entrées et configuration

Lisez d'abord les notes de version et inspectez le produit en cours. Ne collectez que ce qu'ils ne peuvent pas fournir : les modifications à annoncer, une URL de démo ou une application locale, des données d'exemple sûres, des fichiers de marque/police et les tailles demandées. La version une couvre les modifications visibles de l'application web. Ne traitez pas les modifications uniquement API plutôt que d'inventer un tableau de bord. N'annoncez pas une fonctionnalité comme livrée sur la base d'un aperçu à venir.

Vérifiez Node 20+, ffmpeg et Chrome (scripts/chrome.mjs, ou CHROME_PATH). Installez puppeteer-core@^24 dans le projet en cours (il fonctionne sur Node 20 ; les versions majeures plus récentes peuvent nécessiter un Node plus récent). SKILL_DIR ci-dessous est le dossier contenant ce fichier.

mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'

Créez un dossier de film séparé pour chaque modification ; la référence est le contrôle d'apparence, et examples/compare-matching-stays/ montre une liste native. Supprimez les captures copiées après avoir étudié leur format et remplacez-les par celles de ce produit. Supprimez le dossier out/ copié s'il est présent. Gardez chaque film autonome. Lors des versions ultérieures, réutilisez la marque et les clips inchangés ; ne recapturez que les actions modifiées.

Produit et histoire

Écrivez PRODUCT.md avec le produit réel, la marque, les autorisations de données et la source de chaque affirmation de version. Écrivez STORY.md avec une entrée par clip : ID stable, source/date de version, titre, état avant, itinéraire accessible, contrôle/action réel, résultat conservé, méthode de réinitialisation, limites de capture et politique de lecture prévue. Chaque clip indépendant doit avoir un sens à côté de son texte de version. Ne combinez pas deux modifications en une seule chronologie.

Faites correspondre le titre à la démonstration achevée : choisir un point de relecture n'est pas exécuter une relecture, et prévisualiser un planning parsé n'est pas l'enregistrer. Dites « Choisir… » ou « Prévisualiser… » lorsque c'est le résultat réel ; n'empruntez pas l'affirmation plus large de la version pour une démonstration plus étroite.

Avant de vous engager sur une modification, mesurez son composant natif complet et le texte de résultat décisif à la taille de visualisation réelle. Enregistrez les dimensions CSS, la taille du texte et la taille résultante de 358 px dans l'histoire. Une demande de deux clips ne signifie pas qu'il existe deux modifications appropriées. Gardez un élément incompatible et dites pourquoi ; ne le livrez jamais comme un clip fini pour téléphone/réseau social avec une clause de non-responsabilité en petits caractères. Sélectionnez une autre modification réellement documentée si elle convient. Lorsque plusieurs formats sont demandés et que l'utilisateur n'a pas nommé la modification, mesurez chaque candidat documenté par rapport à chaque format demandé avant de choisir, et préférez celui dont le composant complet s'adapte à tous ; ne livrez une famille partielle que lorsqu'aucun ne convient. Si aucun ne convient, signalez la limitation du produit sans inventer d'interface utilisateur ni abaisser le seuil.

Un composant peut ne convenir qu'à certains formats. Déclarez chaque format non pris en charge et sa raison mesurée dans clip.json's heldShapes (par exemple {"4:3":"Le résultat natif est de 10,7 px à 358 px ; seuil 12"}). Le peintre, la pré-vérification et l'exportateur omettent ce format retenu, tout en vérifiant et en livrant les formats compatibles. Le manifeste marque cela comme partiel ; signalez de manière visible chaque format demandé manquant. Une famille partielle n'est pas une preuve de trois formats réussie. Si chaque format est retenu, livrez les mesures/rapport, pas un film.

Soumettez ce plan pour examen, sauf si l'utilisateur a demandé un travail non supervisé. Par défaut, 1200 × 900 (web), 1080 × 1080 (carré) et 1080 × 1350 (portrait). Ce sont des compositions séparées, pas des recadrages d'un seul film. Un titre de version court et fixe se trouve en dehors de l'interface utilisateur sur les réseaux sociaux ; le clip web utilise le texte de version adjacent.

Capture et adaptation

  1. Trouvez une carte ou un panneau natif complet qui contient à la fois l'action et son résultat. Vérifiez sa disposition native étroite avant la capture. À une largeur d'affichage de 358 px, l'étiquette, la valeur ou le résultat modifié doit être d'environ 12 px ou plus. Si le composant complet ne peut pas répondre à cette exigence, choisissez une vue compacte que l'application possède réellement ou signalez la limitation. Ne le redessinez ni ne le restylez jamais pour le film.
  2. Copiez/adaptez film/plans/capture.json et son capture-setup.mjs. Définissez son URL, sa fenêtre d'affichage, ses sélecteurs, sa configuration d'échantillonnage et les preuves inspect. Enregistrez piece et target dans rects.before, puis à nouveau après le résultat. Capturez l'ensemble de la surface before, hover, pressed, changed (toujours survolé) et result (pointeur effacé). Utilisez un vrai appui/relâchement de souris pour que l'application fournisse sa propre pression. Exécutez node scripts/centring.mjs film/plans/capture.json --no-crawl avant la capture.
  3. Exécutez node scripts/screens.mjs film/plans/capture.json film/captures. Utilisez animate pour les propres images CSS/Web Animations de l'application. Incluez suffisamment de limites pour la plus grande étendue native ; l'outil de capture mesure la région avant l'action. Pour une action instantanée, une courte duration explicite enregistre des preuves avec found: [] : passez instantanément à la capture complète. Pour un mouvement piloté par JS que l'outil de capture ne peut pas rechercher, fournissez un enregistrement natif déterministe ; ne le remplacez jamais par un fondu ou un mouvement assemblé à partir d'images fixes.
  4. Copiez la police sous licence du produit dans film/fonts/, définissez film/clip.json et exécutez node scripts/build-clip.mjs film film/clip.json. Les options sont présentées ci-dessous. Il dérive la géométrie de l'ensemble de la surface, la cible du curseur et les liaisons d'images natives à partir de captures/screens.json, échantillonne les surfaces natives, écrit config.js et exécute les vérifications de taille native pour chaque format. Un échec retient l'élément : arrêtez-vous avant de l'exporter. Examinez chaque capture avant de l'utiliser. La référence fournie a déjà sa configuration, donc la reconstruire est facultatif.
{
  "id": "new-view", "title": "Votre titre de version", "kind": "panel",
  "paper": "#F7F4EE", "ink": "#17191F", "groundSource": "Votre palette approuvée ou surface d'application échantillonnée",
  "radius": 20, "clearOnExit": true, "primaryTextPx": 24,
  "font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}

primaryTextPx est la taille CSS native mesurée du texte de résultat décisif, pas une cible inventée par le film. paper provient de ce produit, pas de l'exemple ci-dessus. radius est le rayon natif du composant en pixels CSS. clearOnExit maintient le survol jusqu'à ce que le pointeur quitte la cible réelle. Adaptez ces champs et l'objet timing facultatif dans config.js ; conservez le peintre à caméra fixe et surface entière dans film.js. Les images d'animation natives sont lues à leur fréquence d'images capturée. Si l'action est plus longue, déplacez le départ du curseur et la réinitialisation plus tard pour qu'elle se termine et que le résultat stable soit lisible pendant au moins une seconde ; la référence laisse plus de quatre secondes. Ne tronquez pas le traitement réel et ne présentez pas une requête en file d'attente comme terminée.

Gardez le pointeur au repos loin de l'étiquette critique. Préférez le contrôle visible lui-même comme rects.target ; pour une ligne étiquetée, clip.json peut définir "targetFraction": [0.72, 0.5] pour choisir un point clair à l'intérieur de cette zone de clic réelle (par défaut [0.5, 0.5]). Adaptez capture-setup.mjs pour déplacer la souris réelle vers les mêmes fractions de la boîte englobante de cette cible avant l'appui/relâchement. La capture et le film doivent utiliser le même point ; déplacer uniquement le pointeur dessiné représenterait mal la pression native. Vérifiez-le dans les images d'action à largeur de téléphone décodées.

Révision et livraison

node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film

Ces commandes de livraison se terminent. Pour un travail non supervisé, attendez les deux, terminez la révision et signalez le lecteur film/out/index.html et les chemins des médias exportés. L'aperçu interactif est un outil d'édition assisté : node scripts/preview.mjs film démarre un serveur persistant jusqu'à ce qu'il soit arrêté avec Ctrl-C. Exécutez-le séparément lorsque quelqu'un est présent pour l'utiliser ; ne l'ajoutez jamais à une commande de livraison/vérification non supervisée en premier plan.

export-clips.mjs vérifie d'abord chaque format et refuse les nouvelles exportations vidéo en cas d'échec de la vérification du film. Il rend ensuite des MP4 H.264 silencieux à 30 ips, des WebM VP9 et des PNG de résultat dans film/out/. Son --poster <secondes> facultatif sélectionne un résultat stable (par défaut 3,5). Il écrit un lecteur local avec contexte adjacent, pause/lecture et gestion du mouvement réduit. La réinitialisation du film est étiquetée ; ce n'est pas un cycle de produit transparent. Conservez l'affiche du résultat statique pour le mouvement réduit. L'étiquette apparaît avant la réinitialisation et reste visible jusqu'à la fin ; inspectez également les dernières et premières images décodées.

Lisez chaque bande de modification de l'interface utilisateur en taille réelle, survol/pression/relâchement et réinitialisation dans chaque format ; inspectez les images MP4 décodées à ces événements. Notez avec critique.md, puis obtenez un nouveau réviseur si disponible. Corrigez la source et répétez uniquement les vérifications affectées. Aucun score inférieur à 8 ; après deux cycles de correction infructueux, signalez le défaut restant plutôt que de le cacher. La vérification de stress couvre les mots dessinés, alors inspectez le texte natif capturé séparément à 358 px.

Livrez les films modifiables avec toutes les captures/polices et licences locales, les chemins MP4/WebM/poster, les légendes de version, les revendications de source, la commande de régénération et REVIEW.md avec les scores et les limitations. Ouvrez les MP4 finis pour révision. Visez un clip web de moins de 1 Mo, en préservant d'abord la lisibilité ; rapportez les octets réels et le temps écoulé.

Les boucles par défaut sont silencieuses. music/README.md explique la chanson facultative incluse créée avec IA (prise A sélectionnée). Ne remplacez jamais par une partition synthétisée. Une chanson fournie ou sélectionnée utilise l'adaptateur maison ; conservez les exports silencieux pour les intégrations.

Invariants

  • Captures de produit réelles et données propres à l'utilisateur / d'exemple uniquement. Pas d'interface utilisateur inventée, de rectangles soulevés, de correctifs de texte, de fondu enchaîné entre les états ou de traitement factice.
  • Enveloppe native complète, espacement pair opposé, échelle fixe et caméra. Pas de vaguelettes de clic supplémentaires ni de maquettes d'appareil.
  • seek(t, values) peint à partir des arguments uniquement ; ctx.reset() à chaque image, toiles principales/auxiliaires avec support CPU, images locales préparées. Pas d'horloges, d'appels aléatoires, de minuteries ou de réseau dans le peintre.
  • Chaque mot du film est une entrée template.fields. Le texte natif critique doit être lisible indépendamment des vérifications de stress de copie dessinée.
  • Une réinitialisation ne prétend jamais annuler un achat, un envoi ou une action irréversible. Utilisez une réinitialisation d'état d'échantillon explicitement étiquetée, ou jouez une fois et conservez le résultat réel.

Ostlery est une entreprise fictive créée pour les exemples d'omnigami.

Cette compétence appartient à omnigami, © 2026 Auberon LLC. Utilisez ce qu'elle produit pour n'importe quoi, y compris un usage commercial, et modifiez la compétence pour votre propre usage ; ne redistribuez pas et ne vendez pas la compétence. Conditions complètes : LICENSE.md

Individual skills in this repo

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

Skills associés