Communitygithub.com

bassam1998new-ops/hyperframes-students

Construisez une vidéo dans le style Hatch Cosmos — un monde dessiné au crayon hachuré sur une toile, un mascotte en blocs (ou une paire) qui marche, regarde, cligne des yeux et fait ^^, un plongeon à travers son œil vers une galaxie hachurée de nébuleuses, d'anneaux inclinés et d'étoiles en aiguilles.

Qu'est-ce que hyperframes-students ?

Cette compétence permet aux agents IA de générer des vidéos animées dans le style unique « Hatch Cosmos », un univers dessiné à la main avec des hachures au crayon, des contours à l'encre et un mascotte en blocs. L'élément signature est un plan qui plonge dans l'œil du mascotte, ce dernier se transformant en une fenêtre en forme de téléphone pour laisser place à la scène suivante. La compétence s'applique via un système de cartes de style et de kits d'actifs, avec un processus de validation rigoureux (« judge loop ») qui vérifie la conformité visuelle par des captures d'écran et une analyse comparative. Elle supporte les formats 9:16 et 16:9 et est destinée à des teasers musicaux, des intros conceptuelles avec mascotte, ou des clips « voyage à l'intérieur ». Elle n'est pas adaptée aux têtes parlantes, aux screencasts, aux vidéos explicatives denses ou aux rendus photographiques.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bassam1998new-ops/hyperframes-students/tree/HEAD/.claude/skills/style-hatch-cosmos

Demander à votre IA préférée

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

Documentation

Style : Hatch Cosmos

Un cosmos chaleureux dessiné à la main : aplats plats sous de courtes hachures au crayon en diagonale, contours à l'encre, un mascotte en blocs qui agit, et UN mouvement signature — la caméra plonge dans l'œil du mascotte, l'œil devient une fenêtre en forme de téléphone, et la scène suivante défile. Carte : video-projects/_library/styles/hatch-cosmos/style.md (statut brouillon — le dire au propriétaire jusqu'à ce qu'il l'approuve sur le tableau).

Regardez d'abord (dans le dossier du style) : frames/01-pair-happy-eyes.png · frames/02-eye-window-dive.png · frames/03-deep-galaxy.png · frames/04-paper-walk.png. Référence (visuelle uniquement) : refs/ref-contact-sheet.jpg (pas dans le dépôt public), refs/ref-dive-30fps.jpg (pas dans le dépôt public). Les couleurs suivent la marque : tests/2026-10-02-themes-and-looks.jpg (pas dans le dépôt public).

0. Appliquez d'abord la carte

node tools/vid.mjs style apply hatch-cosmos <projet> [--mode calm|punchy]
node tools/vid.mjs style show hatch-cosmos

Ensuite, lisez le README du kit : video-projects/_library/assets/kits/hatch/README.md. Ne dessinez pas à la main ce que le kit contient.

1. Couleurs = rôles (la marque remplit le hex)

Le style = qualité et mouvement. N'envoyez jamais l'orange / l'espace de référence sauf si la marque le demande. HATCH.kit({ theme: "<nom>" | { …tokens } }) :

JetonRôleDepuis la marque
canvas / haloespace, halo de galaxietoile / surface
inkcontours, yeux, crayon foncétext-strong (le plus foncé)
paper / lightfeuille de papier, traits de crayon pâlestoile claire / blanchâtre
hero / buddyles deux corps du mascotteprimary / surface ou secondary
a1..a6anneaux, points, planètes, rayons — a2 fait les GROSSES massesaccents de la marque ; a2 = un calme, jamais la couleur de "ponctuation"
cloudsremplissages de nébuleuselaisser vide → dérivé (ne jamais définir manuellement)
Enregistrés : cosmos (référence, tests uniquement), midnight. Le hachurage / la lumière / la lueur du mascotte dérivent de la couleur du corps.

2. Construisez-le

  • Partez d'un bloc de démo (copie hatch.js, GSAP, le whoosh) :
    node tools/vid.mjs use hatch-cosmos-9x16 <projet>    # _library/compositions/portrait/hatch-cosmos-9x16.html (6 s)
    node tools/vid.mjs use hatch-cosmos-16x9 <projet>    # _library/compositions/hatch-cosmos-16x9.html (6 s)
    
    Branchez le <div … data-composition-src=…> imprimé avec data-variable-values='{"theme":"<marque>","look":"space|paper"}'. vid use conserve les fichiers existants — après une mise à jour du kit, copiez à nouveau hatch.js. Rendu de démo : styles/hatch-cosmos/tests/demo-9x16-20261002.mp4, demo-16x9-20261002.mp4.
  • Une nouvelle scène avec le kit (un <canvas class="clip" data-layout-allow-overflow"> par composition) :
    1. var K = HATCH.kit({ w, h, seed, theme }) — puis construisez CHAQUE forme une fois, dans un ordre fixe (le rng est consommé dans l'ordre de construction) : K.blob, K.planet, K.stars, K.galaxy(), K.travel({ ys, xs, look }), K.mascot(...), K.speed().
    2. Un proxy GSAP tween {t:0→DUR} avec onUpdate → draw(t) ; enregistrez window.__timelines[id] en ligne dans le HTML (lint doit le voir).
    3. draw(t) cherche le canvas paresseusement (le bundler peut déplacer les scripts), ne dessine qu'à partir de t, se termine par K.lift(ctx, 3).
    4. Les scènes en montage = nouvelles fonctions draw sur les mêmes parties du kit (blobs, anneaux, planètes, étincelles, contours K.wobble) ; changez-les par des coupures franches ou un plongeon.
  • Armature du mascotte : var m = K.mascot({ role: "hero", radius: 7, mark(c, BW, BH) }) ; K.drawMascot(c, m, x, y, scale, state) avec state = { walk: t, walkAmt, legWiggle, look -1..1, eyes: "open"|"happy"|"blink", wave, waveSide, zoom: camScale, glowAmt }. Agissez dans de petites fenêtres (HATCH.win, HATCH.sstep) : regardez le compagnon → ^ ^ (~0,6 s) → clin d'œil → salutation. glowAmt: 0 sur le papier. Logos sur un mascotte uniquement si la marque le dit.
  • Le plongeon : var D = K.dive({ z0, z1, smax: 160, eyeScale, centre, target: t => K.eyePoint(x, y, scale, -1), inner: { start, end, zEnd, fitK, roll: -0.9 } }), puis par image D.frame(ctx, t, drawOuter, drawInner, K.speed(), grain). Les valeurs par défaut correspondent à la référence : calmer la marche 0,45 s avant z0, pousser ~0,85 s, la fenêtre couvre ~0,8 s à l'intérieur, la scène intérieure se stabilise à end. Whoosh sfx/el/whoosh-tonal.mp3 à z0 − 0,15.
  • Disposition 9:16 (1080×1920) : paire centrée sur la zone de sécurité (510, 860), échelle 1,2, distants de 410 px ; centre: [510, 860] pour que l'œil et le cœur de la galaxie atterrissent dans x 60–960, y 220–1500 ; déplacement ys 1,6, xs 0,6. 20 % inférieur uniquement en arrière-plan.
  • Disposition 16:9 : paire à (CX ∓ 270, CY + 10), échelle 1,35 ; galaxie zEnd 1,35.
  • Rythme : intro calme 4–6 s, plongeon 1,2 s, montage toutes les 1–2 s, une pause de 3–5 s, zoom arrière vers le mascotte pour finir (le JSON de la carte contient les paramètres de mouvement).
  • Son : axé sur la musique — un fond léger et ludique du catalogue musique / bgm de _library (ne jamais générer de musique) ; whoosh à chaque plongeon ; voix −14 LUFS s'il y en a une.

3. La boucle de juge (le propriétaire veut « exactement la même qualité »)

  1. npx hyperframes lint + npx hyperframes check dans le projet — 0 erreurs.
  2. npx hyperframes snapshot --at <walk, mid-dive, window, settled> — Lisez chaque image.
  3. npx hyperframes render --quality draft → node tools/vid.mjs judge <mp4> → Lisez sheet.jpg et safe-sheet.jpg ; recherchez les images plates (un écart de capture ponctuel s'est produit une fois — re-rendu, ne touchez pas au code si les instantanés s'affichent correctement).
  4. Par rapport à la référence : paires pleine taille appariées (marche, mi-plongée, galaxie) + recadrages à 100 % (hachures sur un blob, anneau + planète, étincelles, contours, le mascotte) + une bande à 10 ips du plongeon pour les deux. Échantillonnez les couleurs avec ffmpeg (médianes de région), pas à l'œil.
  5. Écrivez tests/<date>-judge-round-N.md — une ligne par élément, verdict identique / différent / impossible à comparer (pourquoi). Corrigez chaque « différent », re-rendu, re-évaluation (max 5 tours). Pourcentage de correspondance honnête pour l'apparence et le mouvement dans le rapport.

À faire / À ne pas faire

  • À faire : rôles de la marque ; construire une fois, dessiner à partir de t ; hachures fixes sur les formes et fines en zoomant ; agir avant chaque plongeon ; zone de sécurité sur 9:16 ; recadrages à 100 % dans l'évaluation.
  • À ne pas faire : couleurs de référence sur une marque qui ne les utilise pas ; texte dessiné dans le canvas (les mots vont à l'extérieur, entiers, jamais divisés par lettre) ; Math.random / Date.now ; hachures bouillonnantes ou épaisses ; crédits sur ce style ; approuver la carte vous-même.

Après le travail : node tools/vid.mjs style comment hatch-cosmos "<ce qui a fonctionné ou non>".

Individual skills in this repo

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

bassam1998new-ops/hyperframes-students

Make a new video with a beginner, start to finish — a few easy questions, pick a look from this repo's styles, build it with HyperFrames, check the frames, render and show it. Use when the student says "new video", "make a video", "اعمل فيديو", "عايز فيديو", "reel", "animation", or asks how to start a video. Hands the technical HyperFrames rules to the official hyperframes skills.

bassam1998new-ops/hyperframes-students

First-time setup for the HyperFrames student studio. Checks the computer (Git, Node.js, FFmpeg, the render browser), explains in plain words what is missing, recommends what to install, asks before installing anything, then makes a 3-second test video to prove it all works. Use when the student says "setup", "install", "اعمل setup", "نزّل البرامج", "it doesn't work", "command not found", when node_modules is missing, or when `npx hyperframes doctor` shows a red item. Safe to run again any time — it skips what is already done.

bassam1998new-ops/hyperframes-students

Build a video in the Amber Grid Newsroom look (style card amber-grid-newsroom) — a hot "breaking news" desk: near-black grid field, the real screen recording in a framed window with instant reframes, an English title over an Arabic title line, and karaoke captions where the spoken word turns hot. Use when the director picked this card, or the owner says "make it in the amber newsroom style", "news desk", "breaking news look", "زي ريل opus 5.5", "ستايل الأخبار", or the video is AI news or a build show-off cut from his OBS screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Cream Caret Type look (style card cream-caret-type) — Arabic words typed with a coloured caret on a flat two-colour page (night and paper that swap on hard cuts), select-highlight → delete → retype, a flat profile silhouette, one coloured dot that match-cuts into a flat vector eye, a zoom-through the iris, a fixed noun with a bold verb swapping every 16 frames, a pixel-art icon on the sign-off and a monogram end card — one sound per event, silence between. Use when the director picked this card, or the owner says "the typing intro", "caret type", "cream caret", "زي فيديو الكتابة", "الكلام اللي بيتكتب", "intro بالكتابة", or the video is a channel / "who am I" intro, a course or service intro hook, a short opener before a talking head, a word-play promise line or a bumper. 9:16 only, Arabic-first. Not for talking heads the whole time, screen-recording proof, data-heavy explainers or full spoken subtitles. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Build a video in the Floating Desk Zoom look (style card floating-desk-zoom) — real app windows float as cards on warm paper, a virtual camera hard-cuts in on the action, follows the typing and glides back out. Use when the director picked this card, or the owner says "make it in the floating desk style", "paper desk", "zoom on the screen like the launch video", "اعمله على الورق", or the video is a build show-off, quick tutorial or AI news made from his OBS screen recording with a voice-over. Arabic or English; 9:16 reels. Not for lecture clips or talking heads.

bassam1998new-ops/hyperframes-students

Build a video in the Horizon Prompt One-shot look (style card horizon-prompt-oneshot) — one continuous camera on a near-black stage lit by a soft planet-horizon glow; a glass app bar, a cursor and a prompt box morph into each other, a prompt is typed, the send button grows into a tile that blooms into a full-frame result, then a light wipe to a logo end card, every beat hit-synced to a UI sound. Use when the director picked this card, or the owner says "horizon prompt", "the prompt one-shot", "the ChatGPT-style promo", "زي فيديو البرومبت", "الكيرسر اللي بيكتب البرومبت", or the video is an AI tool show-off / prompt-to-result demo, a course or service promo opener, a launch teaser or a channel bumper. Not for talking heads, real screen-recording proof, data-heavy explainers or long tutorials. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Remix 2+ existing style cards of the Hyperframes video workspace into one NEW draft style card, layer by layer (palette roles, type, texture, grade, camera, light, edit rhythm, transitions, motion, sound, prompt parts), then let the owner pick the skills for the video and start the director. Use when the owner says "hybrid style", "remix styles", "mix two styles", "combine styles", "اعمل هايبرد", "ادمج الستايلين", or ticks cards and presses "Remix these" on the Styles board.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Kinetic Type look (style card midnight-kinetic-type) — clean motion type on a flat dark field, word-by-word mask rises, one accent word that lands alone, icon strokes that draw on, and hard cuts on the music's beat grid. Use when the director picked this card, or the owner says "make it in the kinetic type style", "midnight type", "like an earlier project", "تايبوجرافي متحركة", or the video is a direct offer, proof / results reel or AI news told with type, music and SFX (no face, no footage). Arabic (Cairo, per-word) and English (Inter) versions; 9:16 reels. Not for lecture clips or quick tutorials.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Screen Desk look (style card midnight-screen-desk) — a calm, organised news desk in three fixed zones: an Arabic info card on top, the real screen recording in a glowing band with punch-ins in the middle, and word-by-word captions (dim → bright) below. Use when the director picked this card, or the owner says "make it in the screen desk style", "three zones", "like the AI releases reel", "كارت فوق والشاشة في النص", or the video is AI news, a build show-off or a quick tutorial cut from his screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Mint Lecture Room look (style card mint-lecture-room) — a calm classroom cut of a real lesson: one long take with slow zooms that follow the point, a topic lower third, a quiz card that asks, counts down think-time and then answers, and karaoke captions that light the current word. Use when the director picked this card, or the owner says "make it in the lecture room style", "lecture clip", "course cut", "quiz card", "قص من المحاضرة", "سؤال وجواب", or the video is a lecture clip or quick tutorial cut from his AI course recordings (Egyptian Arabic). 9:16 reels. Not for AI news or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Neon Node Explainer look (style card neon-node-explainer) — a plain stage, one headline per spoken sentence, and one small glowing diagram (tiles, lines, packets, checks, terminal, tool list) that builds itself part by part. Use when the director picked this card, or the owner says "make it in the neon node style", "node explainer", "API vs MCP style", "اعمله زي فيديو الـ MCP", or the video is an AI explainer, concept explainer, quick tutorial or AI news with a voice-over and no face. Arabic headlines + English mono labels; 9:16 and 16:9 both built. Not for talking heads, warm stories, real screen-recording demos or music-only hype reels.

bassam1998new-ops/hyperframes-students

Build a video in the Swiss Motion Reel look (style card swiss-motion-reel) — a Swiss-grid "instrument panel" with a constant thin HUD, flat 2-colour blocks, word slams, shape match-cuts and hard cuts on a 128 BPM beat. Use when the director picked this card, or the owner says "make it in the Swiss style", "motion reel", "like the motion designer reel", "HUD reel", "ستايل سويسري", or the video is a brand sizzle, product intro, "what we do" reel, launch teaser or any no-person, graphics-only, music-led video. Latin display type with Arabic in a clean geometric sans; built and tested in 16:9, 9:16 still to build. Not for talking heads, screen-recording tutorials or long voice-led explainers.

bassam1998new-ops/hyperframes-students

Build a video in the Warm Glass Face-cam look (style card warm-glass-facecam) — the presenter talks to camera while frosted-glass panels with one warm glow land exactly where he points; blur-punch text, a karaoke pill, small charts, and a shrink into a rounded picture-in-picture for the demo part. Use when the director picked this card, or the owner says "make it in the warm glass style", "glass panels over my face", "face-cam with glass cards", "PiP intro", "كروت زجاج وأنا بتكلم", or the video is a build show-off or quick tutorial with the owner on camera. Source is English 16:9; the 9:16 and Arabic versions still have to be built at the first job. Not for lecture clips or AI news.

bassam1998new-ops/hyperframes-students

Build a video in the <Style name> look (style card <slug>). Use when the director picked this style card, when the owner says "make it in the <Style name> style", "<slug>", "استايل <Style name>", or the video type is <video types from use_when>. Works for Arabic (Egyptian) and English, 9:16 reels<, and 16:9 if supported>. Not for <avoid_when>.

Skills associés