Communitygithub.com

Biznomad/agent-skills

Boucle de développement CLI HyperFrames — `npx hyperframes` pour le scaffolding (init), la validation (lint, inspect), l'aperçu, le rendu et le diagnostic d'environnement (doctor, browser, info, upgrade). Utilisez cette compétence lorsque vous exécutez ces commandes ou que vous résolvez des problèmes de l'environnement de build/rendu HyperFrames. Pour les commandes de prétraitement d'actifs (`tts`, `transcribe`, `remove-background`), utilisez plutôt la compétence `hyperframes-media`.

Qu'est-ce que agent-skills ?

Cette compétence fournit une boucle de développement CLI complète pour le framework HyperFrames, permettant de créer et gérer des projets vidéo programmatiques entièrement depuis le terminal. Le workflow typique comprend le scaffold initial (`npx hyperframes init`), l'écriture de compositions HTML, le linting pour détecter les erreurs de structure, l'inspection visuelle des rendus, l'aperçu avec rechargement à chaud, et le rendu final en MP4 ou WebM. Elle intègre également des commandes de diagnostic (`doctor`, `browser`, `info`, `upgrade`) pour résoudre les problèmes d'environnement comme l'absence de FFmpeg ou de Chrome. La compétence est conçue pour les agents (comme Claude Code, Cursor, Cline) et les développeurs, avec des options de sortie JSON pour les LLM, un linting strict, et une prise en charge des rendus paramétrés via des variables déclarées dans le HTML. Elle nécessite Node.js >= 22 et FFmpeg, et fonctionne sur toutes les plateformes (macOS, Linux, Windows via WSL).

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes-cli

Demander à votre IA préférée

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

Documentation

HyperFrames CLI

Tout s'exécute via npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.

Workflow

  1. Scaffold — npx hyperframes init mon-video
  2. Écrire — composer le HTML (voir la compétence hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspection visuelle — npx hyperframes inspect
  5. Aperçu — npx hyperframes preview
  6. Rendu — npx hyperframes render

Effectuez le lint et l'inspection avant l'aperçu. lint détecte les data-composition-id manquants, les pistes qui se chevauchent et les timelines non enregistrées. inspect ouvre la composition rendue dans Chrome sans tête, parcourt la timeline et signale le texte qui dépasse des bulles/containers ou du canevas.

Scaffolding

npx hyperframes init mon-video                        # assistant interactif
npx hyperframes init mon-video --example warm-grain   # choisir un exemple
npx hyperframes init mon-video --video clip.mp4        # avec fichier vidéo
npx hyperframes init mon-video --audio piste.mp3       # avec fichier audio
npx hyperframes init mon-video --example blank --tailwind # avec le runtime navigateur Tailwind v4
npx hyperframes init mon-video --non-interactive       # ignorer les invites (CI/agents)

Modèles : blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crée la bonne structure de fichiers, copie les médias, transcrit l'audio avec Whisper et installe les compétences AI. Utilisez-le plutôt que de créer les fichiers à la main.

Lorsque vous utilisez --tailwind, invoquez la compétence tailwind avant de modifier les classes ou les jetons de thème. Le scaffold utilise Tailwind v4.2 via le runtime navigateur, pas la configuration Tailwind v3 de Studio.

Linting

npx hyperframes lint                  # répertoire courant
npx hyperframes lint ./mon-projet     # projet spécifique
npx hyperframes lint --verbose        # constatations de niveau info
npx hyperframes lint --json           # lisible par machine

Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger), les avertissements (devrait corriger) et les infos (avec --verbose).

Inspection Visuelle

npx hyperframes inspect                 # inspecte la mise en page rendue sur la timeline
npx hyperframes inspect ./mon-projet    # projet spécifique
npx hyperframes inspect --json          # constatations lisibles par agent
npx hyperframes inspect --samples 15    # balayage plus dense de la timeline
npx hyperframes inspect --at 1.5,4,7.25 # horodatages explicites des images-clés

Utilisez cette commande après lint et validate, en particulier pour les compositions avec des bulles de parole, des cartes, des légendes ou une typographie serrée. Elle signale :

  • Texte s'étendant en dehors du conteneur visuel ou de la bulle le plus proche
  • Texte rogné par sa propre boîte à largeur/hauteur fixe
  • Texte s'étendant en dehors du canevas de la composition
  • Enfants s'échappant des conteneurs de rognage

Les erreurs doivent être corrigées avant le rendu. Les avertissements sont remontés pour examen par l'agent ; ajoutez --strict pour échouer aussi sur les avertissements. Les problèmes statiques répétés sont réduits par défaut afin que la sortie JSON reste compacte pour les fenêtres de contexte LLM. Si un débordement est intentionnel pour une animation d'entrée/sortie, marquez l'élément ou l'ancêtre avec data-layout-allow-overflow. Si un élément décoratif ne doit jamais être audité, marquez-le avec data-layout-ignore.

npx hyperframes layout reste disponible comme alias de compatibilité pour la même passe d'inspection visuelle.

Aperçu

npx hyperframes preview                   # sert le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (défaut 3002)

Rechargement à chaud sur les modifications de fichiers. Ouvre le studio dans votre navigateur automatiquement.

Lorsque vous rendez un projet à l'utilisateur, utilisez l'URL du projet Studio, pas le chemin source index.html :

http://localhost:<port>/#project/<nom-du-projet>

Utilisez le port réel de la sortie d'aperçu et le nom du répertoire du projet. Par exemple, après npx hyperframes preview --port 3017 dans codex-openai-video, indiquez http://localhost:3017/#project/codex-openai-video.

Considérez index.html uniquement comme un contexte de code source. Il est acceptable de le lier en tant que fichier d'implémentation, mais ne le qualifiez pas de projet ou de surface d'aperçu.

Rendu

npx hyperframes render                                # MP4 standard
npx hyperframes render --output final.mp4             # sortie nommée
npx hyperframes render --quality draft                # itération rapide
npx hyperframes render --fps 60 --quality high        # livraison finale
npx hyperframes render --format webm                  # WebM transparent
npx hyperframes render --docker                       # sortie reproductible
FlagOptionsDéfautNotes
--outputcheminrenders/nom_timestamp.mp4Chemin de sortie
--fps24, 30, 603060fps double le temps de rendu
--qualitydraft, standard, highstandarddraft pour l'itération
--formatmp4, webmmp4WebM prend en charge la transparence
--workers1-8 ou autoautoChacun lance Chrome
--dockerflagdésactivéSortie reproductible
--gpuflagdésactivéEncodage accéléré par GPU
--strictflagdésactivéÉchouer sur les erreurs de lint
--strict-allflagdésactivéÉchouer sur les erreurs ET les avertissements
--variablesobjet JSON—Remplace les valeurs des variables déclarées dans data-composition-variables
--variables-filechemin—Fichier JSON avec les valeurs des variables (alternative à --variables)
--strict-variablesflagdésactivéÉchouer le rendu sur les clés non déclarées ou les incompatibilités de type dans --variables

Conseil qualité : draft pendant l'itération, standard pour la révision, high pour la livraison finale.

Rendus paramétrés : la composition déclare ses variables sur la racine <html> avec data-composition-variables — un tableau JSON de déclarations ({id, type, label, default} par entrée) qui définit le schéma. Les scripts à l'intérieur lisent les valeurs résolues via window.__hyperframes.getVariables(). Le CLI --variables '{"title":"Rapport T4"}' est un objet JSON indexé par id qui remplace les valeurs par défaut déclarées pour un seul rendu ; les clés manquantes sont ignorées, donc la même composition reste inchangée en aperçu de développement et en production. (Les hôtes de sous-composition peuvent également remplacer par instance avec data-variable-values — même forme d'objet, limitée à un montage de la sous-composition. Voir la compétence hyperframes pour le schéma complet.)

Prétraitement des actifs

npx hyperframes tts, transcribe, et remove-background produisent des actifs (audio de narration, transcriptions mot par mot, vidéo transparente) qui sont intégrés dans une composition. Chacun télécharge son propre modèle au premier lancement. Pour la sélection de la voix, les règles du modèle Whisper (le piège .en qui traduit les langues non anglaises), le choix du format de sortie (VP9 alpha WebM vs ProRes), et la chaîne TTS → transcrire → sous-titres, invoquez la compétence hyperframes-media.

Dépannage

npx hyperframes doctor       # vérifie l'environnement (Chrome, FFmpeg, Node, mémoire)
npx hyperframes browser      # gère Chrome intégré
npx hyperframes info         # version et détails de l'environnement
npx hyperframes upgrade      # vérifie les mises à jour

Exécutez doctor en premier si le rendu échoue. Problèmes courants : FFmpeg manquant, Chrome manquant, mémoire insuffisante.

Autre

npx hyperframes compositions   # liste les compositions dans le projet
npx hyperframes docs           # ouvre la documentation
npx hyperframes benchmark .    # évalue les performances de rendu

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills associés