Communitygithub.com

oyi77/1ai-skills

Transformez un changelog .md hebdomadaire en une vidéo de marque finie avec HyperFrames. À utiliser lorsque l'utilisateur fournit un changelog/résumé markdown et souhaite une vidéo hebdomadaire, ou dit 'vidéo changelog'. Autonome — polices, arrière-plan, lexique et scripts sont inclus dans la compétence. Produit des vidéos carrées 1080, d'environ 45-60s avec des UI animées de marque.

Qu'est-ce que 1ai-skills ?

Cette compétence transforme un changelog de version en une composition vidéo soignée en utilisant le rendu HTML d'HyperFrames. Elle est conçue pour les développeurs et créateurs de produits qui souhaitent transformer des notes de mise à jour textuelles en annonces visuelles engageantes. La compétence prend en charge les agents AI comme Claude Code, Cursor et Codex, et fonctionne avec un ensemble d'outils incluant HyperFrames, ffmpeg, et des scripts Node.js pour la synthèse vocale et le sous-titrage. Le processus débute par le bootstrap des actifs (polices, musique de fond, motifs d'arrière-plan), puis suit un flux de travail structuré : analyse et coupe éditoriale du changelog, routage de la visualisation (chaque thème est illustré par une maquette animée de l'interface utilisateur réelle), rédaction d'un script à deux couches (parlé vs affiché), génération des timings de mots via TTS, et enfin construction avec des vérifications de qualité strictes. Des portes de validation (hyperframes check, seam-gate.mjs verify) garantissent la conformité avant le rendu final. La compétence produit une vidéo MP4 carrée 1080p d'environ 45 à 60 secondes, avec des sous-titres alignés et un rendu visuel animé qui met en avant chaque changement de fonctionnalité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-changelog-video

Demander à votre IA préférée

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

Documentation

Aperçu

Cette compétence transforme un changelog de version en une composition vidéo soignée en utilisant le rendu HTML d'HyperFrames. Utilisez-la lorsqu'une mise à jour de produit mérite une annonce visuelle — trames héroïques, appels de points clés et motif d'arrière-plan. Elle produit une MP4 rendue à partir des entrées du changelog que vous lui fournissez.

HyperFrames — Vidéo de Changelog

Entrée : un changelog .md (thèmes + éléments). Sortie : un projet HyperFrames propre, vert seam-gate. Ne rendez que lorsque demandé.

Quand l'utiliser

  • L'utilisateur fournit un changelog/résumé markdown et souhaite la vidéo hebdomadaire
  • L'utilisateur dit "vidéo changelog" ou "vidéo digest hebdomadaire"
  • L'utilisateur souhaite une vidéo de marque avec des UI animées et une voix off

Quand NE PAS l'utiliser

  • L'utilisateur souhaite un lancement de produit (utiliser hyperframes-product-launch-video)
  • L'utilisateur souhaite un graphique animé (utiliser hyperframes-motion-graphics)
  • L'utilisateur souhaite une vidéo en plans de parole (utiliser hyperframes-embedded-captions)

La Directive Principale : Visualiser, Ne Pas Lister

Chaque thème est illustré par une maquette animée de l'interface utilisateur réelle ou d'un analogue fidèle qui joue le changement d'expérience — jamais de puces de texte. Routez chaque thème/élément via le registre de visualisation AVANT d'écrire le script.

Flux de Travail

0 · Bootstrap à partir des actifs de la compétence (non négociable)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

Ensuite, lisez references/build-spec.md de bout en bout — il définit les jetons de marque.

1 · Analyse + coupe éditoriale

  • Extraire : plage hebdomadaire, statistiques principales, thèmes, éléments
  • Budget : 45-60s total. Titre ≤2s, outro ≤3,5s, 4 thèmes ≈ 9-12s chacun
  • Par thème, garder UNE visualisation héroïque + au plus 3 éléments parlés
  • Ordonner les thèmes par histoire : fonctionnalité phare → surface produit → performance → fiabilité

2 · Routage de visualisation

Pour chaque thème, choisir la surface depuis le registre de visualisation et écrire une ligne : theme → surface → les 2-4 actions séquencées que la maquette effectue, chacune liée à une phrase du script.

3 · Script à deux couches (parlé vs affiché)

Écrire le script sous forme de lignes de jetons : registre conversationnel, chaque terme technique portant une forme phonétique spoken tandis que display conserve l'orthographe standard. Les sous-titres montrent display ; la VO lit spoken.

4 · VO + horodatages des mots

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

Les timings des mots sont une porte dure. Avant de continuer, vérifiez que vo-words.json n'est pas vide et possède un tableau words: [...] avec start/end pour chaque mot.

5 · Construction

Suivez exactement references/build-spec.md : jetons de marque + polices + encodage d'arrière-plan animé + canevas de scène + chrome + rail de sous-titres. Puis l'ordre de la doctrine : registre vectoriel → timbre seam → battements internes sur les mots de la VO → vérification seam-gate.

Les sous-titres ne sont pas optionnels. Remplissez le tableau LINES à partir de captions.json avant de continuer.

6 · Portes (toutes vertes avant de présenter)

  1. hyperframes check — 0 erreurs
  2. seam-gate.mjs verify — 0 échec
  3. Redémarrer le serveur de prévisualisation, vérifier 3-4 battements
  4. Ne PAS rendre sauf si l'utilisateur le demande
  5. Porte de présence des sous-titres — échantillonner 3-4 images, confirmer que le rail de sous-titres est visible

Tableau Anti-Rationalisation

RationalisationRéalité
"Diapositives à puces pour les changements UI"Maquetter la surface qui joue le changement
"Fausse UI pour les éléments non représentables"Scène de liste honnête
"'JSON' simple dans le texte TTS"Formes parlées du lexique ; affichage reste standard
"Deviner la prononciation"Demander, puis enrichir le lexique
"Parler de chaque élément du changelog"≤3 par thème ; le lien de digest prend le reste
"Accents verts partout"Un moment vert par scène
"Partir du index.html d'une vidéo précédente"Copier master-skeleton.html, toujours
"Un tableau LINES vide est acceptable"LINES vide = livraison sans sous-titres = refaire le run

Vérification

  • hyperframes check passe avec 0 erreurs
  • seam-gate.mjs verify passe avec 0 échec
  • Rail de sous-titres visible sur 3+ images échantillonnées
  • Horodatages des mots alignés avec l'audio
  • Jetons de marque correspondent à build-spec.md
  • Rendu uniquement lorsque l'utilisateur le demande explicitement

Individual skills in this repo

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

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

Skills associés