Communitygithub.com

bassam1998new-ops/hyperframes-students

Erstmalige Einrichtung des HyperFrames-Studentenstudios. Überprüft den Computer (Git, Node.js, FFmpeg, den Render-Browser), erklärt in einfachen Worten, was fehlt, empfiehlt die Installation, fragt vor jeder Installation um Erlaubnis und erstellt einen 3-Sekunden-Testvideobeweis. Verwenden Sie dies, wenn der Student „setup“, „install“, „اعمل setup“, „نزّل البرامج“, „es funktioniert nicht“, „Befehl nicht gefunden“ sagt, wenn node_modules fehlt oder wenn `npx hyperframes doctor` einen roten Eintrag anzeigt. Kann jederzeit erneut ausgeführt werden – es überspringt bereits Erledigtes.

Was ist hyperframes-students?

Dieses Skill richtet den Computer eines Anfänger-Studenten für die Arbeit mit HyperFrames ein – einem tool zur Videoproduktion basierend auf Claude AI. Es führt eine umfassende Überprüfung durch, ob Git, Node.js (Version 22+), npm, FFmpeg/FFprobe und genügend Speicherplatz vorhanden sind. Fehlende Komponenten werden dem Benutzer in einfacher Sprache erklärt und eine Installation empfohlen – jede einzelne muss jedoch vom Benutzer zuerst bestätigt werden. Anschließend installiert es die studiolokalen Teile: `npm install`, `npx hyperframes skills` und `npx hyperframes browser ensure`. Als finalen Test erstellt es ein 3-Sekunden-Testvideo mit einem leeren Beispielprojekt. Das Skill läuft plattformübergreifend (Windows, macOS, Linux) und ist für absolute Anfänger optimiert: kurze Anweisungen, keine rohen Terminalausgaben, keine Passwörter werden vom Skill eingegeben. Es ist sicher, es mehrfach auszuführen – Erledigtes wird übersprungen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bassam1998new-ops/hyperframes-students/tree/HEAD/.claude/skills/setup

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Einrichtung – Bereiten Sie den Computer eines Anfängers vor

Der Student ist ein Anfänger. Sprechen Sie in seiner Sprache, kurze Sätze, Schritt für Schritt. Führen Sie die Überprüfungen selbst durch. Fragen Sie vor jeder Installation um Erlaubnis. Geben Sie niemals ein Passwort für sie ein.

0. Das richtige Verzeichnis?

Dies muss innerhalb des Studio-Ordners ausgeführt werden (enthält CLAUDE.md und video-projects/_library/). Wenn Sie sich woanders befinden, suchen Sie den Ordner oder fragen Sie, wohin er geklont wurde, und wechseln Sie dorthin (cd).

1. Prüfen, was vorhanden ist

Ermitteln Sie das System (Windows / macOS / Linux) und führen Sie diese Befehle aus. Zeigen Sie nicht die rohe Ausgabe; zeigen Sie eine kurze Liste.

PrüfungBefehlBenötigt?Was es ist, in einem Satz
Gitgit --versionjalädt dieses Studio und seine Updates herunter
Node.js 22 oder neuernode --versionjaführt HyperFrames aus
npmnpm --versionjawird mit Node.js mitgeliefert
FFmpeg + FFprobeffmpeg -version, ffprobe -versionjafügt die Bilder und den Ton zu einem MP4 zusammen
Freier Speicherplatz(wird von doctor angezeigt)~3 GBfür die Werkzeuge und Ihre Videos

Zeigen Sie es so an:

✓ Git
✗ Node.js – nicht installiert (benötigt: es führt HyperFrames aus)
✓ FFmpeg

Wenn alles ✓ ist, sagen Sie dies und gehen Sie zu Schritt 3.

2. Fehlendes installieren – erst fragen, einzeln

Für jedes ✗: Sagen Sie, was es ist (ein Satz), dass es kostenlos ist, was Sie empfehlen, und fragen Sie „Soll ich es installieren?“. Warten Sie auf ein Ja.

Windows (winget ist in Windows 10/11 integriert):

  • Node.js: winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
  • FFmpeg: winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements
  • Git: winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements
  • Wenn Windows ein Fenster „Möchten Sie zulassen, dass diese App Änderungen an Ihrem Gerät vornimmt?“ anzeigt, sagen Sie ihnen, sie sollen auf Ja klicken.
  • Wenn winget selbst fehlt: Senden Sie sie zu https://nodejs.org (der LTS-Button), https://git-scm.com und für FFmpeg sagen Sie „Installieren Sie den App Installer aus dem Microsoft Store, dann versuche ich es erneut“.

macOS (verwendet Homebrew):

  • Prüfen Sie brew --version. Wenn es fehlt, müssen sie den Installer selbst ausführen, da er nach ihrem Mac-Passwort fragt. Sagen Sie ihnen: Öffnen Sie die Terminal-App, fügen Sie den Befehl von https://brew.sh ein, drücken Sie die Eingabetaste, geben Sie ihr Mac-Passwort ein (es bleibt unsichtbar während der Eingabe – das ist normal), und sagen Sie Ihnen Bescheid, wenn es fertig ist.
  • Dann: brew install node ffmpeg git

Linux: Diese benötigen ihr Passwort, also führen sie sie in ihrem eigenen Terminal aus: sudo apt install -y git ffmpeg. Für Node.js 22+ empfehlen Sie den LTS-Installer von https://nodejs.org.

Nach der Installation von etwas: Das neue Programm ist für dieses Claude-Fenster noch nicht sichtbar. Sagen Sie ihnen: „Schließen Sie Claude Code vollständig, öffnen Sie es erneut in diesem selben Ordner und geben Sie /setup ein – ich mache hier weiter.“ Dann anhalten und warten. (Wenn sie zurückkommen, zeigt Schritt 1 das neue ✓.)

3. Die studiolokalen Teile installieren

Sagen Sie, was jeder Teil tut und wie groß er ungefähr ist, dann führen Sie sie der Reihe nach aus:

  1. npm install – lädt HyperFrames in diesen Ordner herunter (ca. 120 MB, etwa eine Minute).
  2. npx hyperframes skills – bringt Claude die offiziellen HyperFrames-Regeln bei (klein). Fragen Sie zuerst: Es installiert Skills für Claude auf diesem Computer.
  3. npx hyperframes browser ensure – lädt eine private Kopie von Chrome herunter, die nur zum Erstellen von Videos verwendet wird (~150 MB). Ihr normaler Browser wird nicht berührt.
  4. npx hyperframes doctor – die abschließende Prüfung. Erklären Sie nur die roten Elemente, die wichtig sind: Node.js, FFmpeg, FFprobe und Chrome müssen ✓ sein. Diese sind optional – ignorieren Sie sie: eine neuere Version verfügbar, whisper-cpp (automatische Untertitel), MusicGen (KI-Musik), Docker.

Nach npx hyperframes skills: Neue Skills werden in einer neuen Sitzung geladen. Sagen Sie ihnen: „Schließen Sie Claude Code und öffnen Sie es erneut in diesem Ordner, dann geben Sie /setup ein – ich fahre beim Testvideo fort.“

4. Beweisen, dass es funktioniert: ein 3-Sekunden-Testvideo

Benötigt Internet (die Animationsbibliothek wird aus dem Web geladen). Führen Sie diese einzeln pro Zeile aus (in PowerShell funktioniert && nicht):

mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test

Das leere Beispiel ist 10 Sekunden lang und zeigt „Title“. Ändern Sie in index.html den Text zu ihrem Namen oder „Hallo“, setzen Sie beide data-duration="10" auf 3, fügen Sie einen Einblend-Effekt hinzu (tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) und tl.set({}, {}, 3); vor der Zeile window.__timelines. Dann:

npx hyperframes lint
npx hyperframes render --quality draft

Finden Sie die MP4-Datei in my-videos/hello-test/renders/, sagen Sie ihnen, wo sie ist, und bieten Sie an, sie zu öffnen. Wenn es fehlschlägt, lesen Sie den Fehler, beheben Sie ihn und versuchen Sie es erneut. Geben Sie ihnen keinen defekten Schritt.

5. Fertig

Sagen Sie ihnen kurz:

  • „Die Einrichtung ist abgeschlossen. Ihre Videos werden im Ordner my-videos gespeichert.“
  • „Um ein Video zu erstellen, geben Sie /new-video ein.“
  • „Öffnen Sie Claude Code beim nächsten Mal in diesem selben Ordner.“ Sagen Sie ihnen den vollständigen Ordnerpfad, den Sie verwendet haben, und wie:
    • Claude Desktop-App: Code-Tab → Ordner wählen / öffnen → diesen Ordner auswählen.
    • Terminal: cd "<der vollständige Pfad>" dann claude.
  • Unter Windows kann „Dokumente“ tatsächlich in OneDrive liegen (OneDrive\Dokumente). Überprüfen Sie, wo das Klon tatsächlich gelandet ist, und geben Sie diesen genauen Pfad an.

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

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 Hatch Cosmos look (style card hatch-cosmos) — a hand-drawn pencil-hatched world on one canvas, a block mascot (or a pair) that walks, looks, blinks and does ^ ^ eyes, a dive through its eye into a hatched galaxy of nebula blobs, tilted rings and needle stars. Use when the director picked this card, or the owner says "hatched", "hatch cosmos", "pencil cosmos", "the galaxy video style", "the mascot dive", "زي فيديو المجرة", "الستايل المرسوم بالقلم", "الكائن اللي بيدخل في عينه", or the video is a music-led show-off/teaser, a concept intro with a mascot, a "journey inside" beat or a channel bumper. 9:16 and 16:9 both built. Not for talking heads, real screen-recording proof, data-heavy explainers or photographic looks.

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>.

Verwandte Skills