Communitygithub.com

bassam1998new-ops/hyperframes-students

首次設定 HyperFrames 學生工作室。檢查電腦是否安裝 Git、Node.js、FFmpeg 與渲染瀏覽器,用白話解釋缺少什麼與建議安裝的項目,詢問後才進行安裝,最後製作一個 3 秒測試影片證明一切運作正常。

hyperframes-students 是什麼?

這個技能專為 HyperFrames 影片製作工具的初學者學生設計,能自動檢查開發環境的完整性,包括 Git、Node.js 22+、npm、FFmpeg/FFprobe 及足夠的磁碟空間。它會以清晰的✓/✗ 清單顯示結果,並對每個缺失的項目用一句話說明其用途與必要性,再詢問使用者是否要安裝。安裝過程支援 Windows (winget)、macOS (Homebrew) 與 Linux (apt),且尊重使用者的密碼自主權。安裝完成後會依序執行 npm install、npx hyperframes skills、npx hyperframes browser ensure 以及 npx hyperframes doctor 來驗證 HyperFrames 本身的元件。最後一步是自動建立一個 3 秒測試影片,修改 index.html 中的持續時間與淡入效果,再執行 npx hyperframes render 產生 MP4,確認整個流程可正常運作。此技能可安全重複執行,只會安裝遺漏的部分,不會破壞既有設定。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設定 — 讓初學者的電腦準備就緒

學生是初學者。用他們的語言、簡短的句子、一次只做一個步驟。 你自己執行檢查。每項安裝前都要先詢問。絕對不要幫他們輸入密碼。

0. 是否在正確的資料夾?

這個步驟必須在工作室資料夾內執行(它裡面有 CLAUDE.md 和 video-projects/_library/)。 如果你不在正確的位置,請找出該資料夾,或詢問他們將專案 clone 到哪裡,然後 cd 過去。

1. 檢查現有工具

判斷作業系統(Windows / macOS / Linux)並執行以下檢查。不要顯示原始輸出,只要簡短列表。

檢查項目指令是否必要一句話說明
Gitgit --version是下載這個工作室及其更新
Node.js 22 或更新版node --version是執行 HyperFrames
npmnpm --version是隨 Node.js 一起安裝
FFmpeg + FFprobeffmpeg -version, ffprobe -version是將影格與聲音合併成 MP4
可用磁碟空間(doctor 會顯示)約 3 GB存放工具與你的影片

顯示方式如下:

✓ Git
✗ Node.js — 未安裝(需要:它用來執行 HyperFrames)
✓ FFmpeg

如果所有項目都是 ✓,告知使用者並直接跳到步驟 3。

2. 安裝缺少的項目 — 逐一詢問

針對每個 ✗:用一句話說明那是什麼、是免費的、你推薦安裝,並詢問「我可以安裝它嗎?」。等待使用者回答「好」。

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 下載到這個資料夾(約 120 MB,大約一分鐘)。
  2. npx hyperframes skills — 教導 Claude 官方的 HyperFrames 規則(很小)。先詢問:它會在這台電腦上為 Claude 安裝技能。
  3. npx hyperframes browser ensure — 下載一份專為製作影片使用的私人 Chrome 副本(約 150 MB)。不會影響他們的一般瀏覽器。
  4. npx hyperframes doctor — 最終檢查。只說明重要的紅色項目: Node.js、FFmpeg、FFprobe 和 Chrome 必須是 ✓。以下為選用 — 忽略它們:有新版本可用、whisper-cpp(自動字幕)、MusicGen(AI 音樂)、Docker。

執行 npx hyperframes skills 後:新的技能會在新的工作階段中載入。告訴他們:「關閉 Claude Code,在相同資料夾重新開啟,然後輸入 /setup — 我會從測試影片繼續。」

4. 證明一切正常:製作一個 3 秒測試影片

需要網路連線(動畫函式庫從網路載入)。請逐行執行以下指令(在 PowerShell 中,&& 無法使用):

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

空白範例預設為 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 桌面應用程式: 程式碼(Code)分頁 → 選擇/開啟資料夾 → 選取該資料夾。
    • 終端機: cd "<完整路徑>" 然後 claude。
  • 在 Windows 上,「Documents」可能實際上是在 OneDrive 內(OneDrive\Documents)。請確認 clone 確實落在哪裡,並給出確切路徑。

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

相關技能