Communitygithub.com

nateherkai/hyperframes-student-kit

Installer et câbler les blocs et composants du registre dans des compositions HyperFrames. À utiliser lors de l'exécution de hyperframes add, de l'installation d'un bloc ou d'un composant, du câblage d'un élément installé dans index.html, ou du travail avec hyperframes.json. Couvre la commande add, les emplacements d'installation, le câblage des sous-compositions de blocs, la fusion des extraits de composants et la découverte du registre.

Qu'est-ce que hyperframes-student-kit ?

Cette compétence permet aux agents IA d'interagir avec le registre HyperFrames pour installer et intégrer des blocs (sous-compositions autonomes) et des composants (extraits d'effets sans dimensions propres) dans des compositions existantes. Elle guide l'agent lors de l'utilisation de la commande `hyperframes add`, en expliquant les chemins d'installation par défaut (modifiables via `hyperframes.json`), les attributs clés pour le câblage des blocs (`data-composition-src`, `data-composition-id`, `data-start`, etc.) et la procédure de collage des composants (HTML, CSS, JS). La compétence couvre également la découverte des éléments disponibles via le manifeste du registre (`registry.json`). Elle est conçue pour les outils comme Claude Code, Cursor ou Codex, et repose sur la documentation du projet HyperFrames.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-registry

Demander à votre IA préférée

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

Documentation

Registre HyperFrames

Le registre fournit des blocs et composants réutilisables, installables via hyperframes add <nom>.

  • Blocs — sous-compositions autonomes (propres dimensions, durée, timeline). Inclus via data-composition-src dans une composition hôte.
  • Composants — extraits d'effets (pas de dimensions propres). Collés directement dans le HTML d'une composition hôte.

Quand utiliser cette compétence

  • L'utilisateur mentionne hyperframes add, "bloc", "composant" ou hyperframes.json
  • La sortie de hyperframes add apparaît dans la session (chemins de fichiers, extrait dans le presse-papiers)
  • Vous devez câbler un élément installé dans une composition existante
  • Vous voulez découvrir ce qui est disponible dans le registre

Référence rapide

hyperframes add data-chart              # installer un bloc
hyperframes add grain-overlay           # installer un composant
hyperframes add shimmer-sweep --dir .   # cibler un projet spécifique
hyperframes add data-chart --json       # sortie lisible par machine
hyperframes add data-chart --no-clipboard  # ignorer le presse-papiers (CI/headless)

Après l'installation, la CLI affiche les fichiers écrits et un extrait à coller dans votre composition hôte. L'extrait est un point de départ — vous devrez ajouter les attributs data-composition-id (doit correspondre à l'ID interne de la composition du bloc), data-start et data-track-index lors du câblage des blocs.

Remarque : hyperframes add ne fonctionne que pour les blocs et composants. Pour les exemples, utilisez hyperframes init <dir> --example <nom> à la place.

Emplacements d'installation

Les blocs s'installent dans compositions/<nom>.html par défaut. Les composants s'installent dans compositions/components/<nom>.html par défaut.

Ces chemins sont configurables dans hyperframes.json :

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Voir install-locations.md pour tous les détails.

Câblage des blocs

Les blocs sont des compositions autonomes — incluez-les via data-composition-src dans votre index.html hôte :

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Attributs clés :

  • data-composition-src — chemin vers le fichier HTML du bloc
  • data-composition-id — doit correspondre à l'ID interne du bloc
  • data-start — moment d'apparition du bloc dans la timeline hôte (en secondes)
  • data-duration — durée de lecture du bloc
  • data-width / data-height — dimensions du canevas du bloc
  • data-track-index — ordre de superposition (plus élevé = devant)

Voir wiring-blocks.md pour tous les détails.

Câblage des composants

Les composants sont des extraits — collez leur HTML dans le balisage de votre composition, leur CSS dans votre bloc de style, et leur JS dans votre script (s'il y en a) :

  1. Lisez le fichier installé (par exemple, compositions/components/grain-overlay.html)
  2. Copiez les éléments HTML dans le <div data-composition-id="..."> de votre composition
  3. Copiez le bloc <style> dans les styles de votre composition
  4. Copiez tout contenu <script> dans le script de votre composition (avant votre code de timeline)
  5. Si le composant expose une intégration de timeline GSAP (voir le bloc de commentaire dans l'extrait), ajoutez ces appels à votre timeline

Voir wiring-components.md pour tous les détails.

Découverte

Parcourez les éléments disponibles :

# Lire le manifeste du registre
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Le fichier registry-item.json de chaque élément contient : nom, type, titre, description, tags, dimensions (blocs uniquement), durée (blocs uniquement) et liste des fichiers.

Voir discovery.md pour les détails sur le filtrage par type et tags.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills associés