Communitygithub.com

bassam1998new-ops/hyperframes-students

HyperFrames 学生スタジオの初回セットアップを行います。Git、Node.js、FFmpeg、レンダリング用ブラウザなど必要なツールを確認し、不足があれば平易な言葉で説明、インストール前には許可を求め、最後に3秒のテスト動画を作成して動作確認します。

hyperframes-students とは?

このスキルは、HyperFrames 学生スタジオを使い始める初心者向けの自動セットアップツールです。学生が「setup」「install」「نزّل البرامج」などと言った時、または `npx hyperframes doctor` でエラーが出た際に、システム環境をチェックし、不足しているツール(Git、Node.js、FFmpegなど)を分かりやすく説明した上で、インストール前に許可を求めます。対応OSはWindows(winget)、macOS(Homebrew)、Linux(apt)です。必要なツールをすべてインストールした後、npm install、skills、ブラウザのダウンロードを実行し、最後に3秒のテスト動画をレンダリングして正常動作を確認します。初心者に配慮した短い文と段階的な指示で構成されており、何度再実行しても安全で、既に完了したステップはスキップされます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

セットアップ — 初心者のコンピュータを準備する

この学生は初心者です。学生の言葉で、短い文で、1ステップずつ説明してください。 確認作業は自分で行い、インストール前には毎回許可を求めてください。パスワードを代わりに入力しないでください。

0. 正しいフォルダですか?

このコマンドはスタジオフォルダ内で実行する必要があります(スタジオフォルダには CLAUDE.md と video-projects/_library/ があります)。 別の場所にいる場合は、フォルダを見つけるか、学生にクローンした場所を尋ねて、cd で移動してください。

1. 何がインストールされているか確認する

OS(Windows / macOS / Linux)を確認し、以下のコマンドを実行してください。生の出力は表示せず、短いリストで示してください。

確認項目コマンド必要?一言で説明
Gitgit --versionはいこのスタジオとそのアップデートをダウンロードするために必要
Node.js 22 以上node --versionはいHyperFrames を実行するために必要
npmnpm --versionはいNode.js に付属
FFmpeg + FFprobeffmpeg -version, ffprobe -versionはいフレームと音声を結合してMP4にするために必要
空きディスク容量(doctor が表示します)約3GBツールと動画のために必要

次のように表示してください:

✓ Git
✗ Node.js — インストールされていません(必要:HyperFrames を実行するため)
✓ FFmpeg

すべて ✓ の場合はその旨を伝え、ステップ3に進んでください。

2. 不足しているものをインストールする — 1つずつ、先に許可を取る

各 ✗ について:それが何か(1行)、無料であること、おすすめすること、そして「インストールしますか?」と尋ねてください。はいの返事を待ってください。

Windows(winget は Windows 10/11 に組み込まれています):

  • 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
  • Windows が「このアプリがデバイスに変更を加えることを許可しますか?」と表示した場合は、「はい」 をクリックするよう伝えてください。
  • winget 自体がない場合:https://nodejs.org(LTSボタン)、https://git-scm.com に誘導し、FFmpeg については「Microsoft Store から App Installer をインストールしてから、もう一度試します」と伝えてください。

macOS(Homebrew を使用):

  • brew --version を確認してください。ない場合は、学生自身がインストーラを実行する必要があります(Macのパスワードが必要なため)。次のように伝えてください:「ターミナルアプリを開き、https://brew.sh のコマンドをコピーして貼り付け、Enterを押し、Macのパスワードを入力してください(入力中は画面に表示されませんが、正常です)。完了したら教えてください。」
  • その後:brew install node ffmpeg git

Linux: パスワードが必要なため、学生が自分のターミナルで実行します: sudo apt install -y git ffmpeg。Node.js 22+ については、https://nodejs.org のLTSインストーラをおすすめしてください。

何かをインストールした後: 新しいプログラムはこのClaudeウィンドウからはまだ見えません。次のように伝えてください:「Claude Code を完全に閉じて、同じフォルダでもう一度開き、/setup と入力してください。ここから続けます。」その後、停止して待機してください。(学生が戻ってきたら、ステップ1で新しい ✓ が表示されます。)

3. スタジオ独自のパーツをインストールする

それぞれの機能とおおよそのサイズを説明し、順番に実行してください:

  1. npm install — HyperFrames をこのフォルダにダウンロードします(約120MB、約1分)。
  2. npx hyperframes skills — Claude に公式の HyperFrames ルールを教えます(小さい)。先に許可を取ってください:この操作により、このコンピュータに Claude 用のスキルがインストールされます。
  3. npx hyperframes browser ensure — 動画作成専用のプライベートなChromeのコピーをダウンロードします(約150MB)。通常のブラウザには影響しません。
  4. npx hyperframes doctor — 最終確認です。重要な赤色の項目だけ説明してください:Node.js、FFmpeg、FFprobe、Chrome が ✓ である必要があります。以下は オプションのため無視してください:新しいバージョンが利用可能、whisper-cpp(自動キャプション)、MusicGen(AI音楽)、Docker。

npx hyperframes skills の後:新しいスキルは新しいセッションで読み込まれます。次のように伝えてください:「Claude Code を閉じて、このフォルダでもう一度開き、/setup と入力してください。テスト動画から続けます。」

4. 動作確認:3秒のテスト動画

インターネット接続が必要です(アニメーションライブラリがWebから読み込まれます)。次のコマンドを1行ずつ実行してください(PowerShellでは && は使えません):

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

blank サンプルは10秒で「Title」と表示されます。index.html 内で:テキストを学生の名前または「Hello」に変更し、両方の data-duration="10" を 3 に設定し、フェードインを追加します(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);)。さらに window.__timelines の行の前に tl.set({}, {}, 3); を追加します。その後:

npx hyperframes lint
npx hyperframes render --quality draft

my-videos/hello-test/renders/ にあるMP4ファイルを見つけ、場所を伝え、開くことを提案してください。 失敗した場合は、エラーを読み、修正し、再試行してください。壊れた状態のまま渡さないでください。

5. 完了

簡潔に伝えてください:

  • 「セットアップは完了しました。動画は my-videos フォルダに保存されます。」
  • 「動画を作成するには、/new-video と入力してください。」
  • 「次回は、同じフォルダで Claude Code を開いてください。」使用したフォルダのフルパスを伝え、以下の方法も説明してください:
    • Claude デスクトップアプリ: コードタブ → フォルダを選択/開く → そのフォルダを選択。
    • ターミナル: cd "<フルパス>" してから claude。
  • Windows の場合、「ドキュメント」は実際には OneDrive 内にある場合があります(OneDrive\Documents)。実際にクローンされた場所を確認し、正確なパスを伝えてください。

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

関連スキル