Communitygithub.com

bassam1998new-ops/hyperframes-students

用霓虹節點解說員(Neon Node Explainer)風格製作影片——簡潔舞台,每句台詞一個標題,搭配一個會逐步建構的小型發光圖表。適用於導演指定此風格,或當事人說「用霓虹節點風格」、「節點解說」、「API vs MCP 風格」、「اعمله زي فيديو الـ MCP」,或影片是 AI 解說、概念解說、快速教學、有旁白且無人物的 AI 新聞。阿拉伯文標題 + 英文單色標籤;同時建構 9:16 與 16:9 版本。不適用於頭像訪談、溫情故事、真實螢幕錄影教學或純音樂宣傳片。

hyperframes-students 是什麼?

此技能用於建立「霓虹節點解說員」風格的影片,這是一種冷靜的科技解說格式:每句口說句子對應一個全畫面標題,標題下方有一個小型發光圖表,會逐步建構(從暗淡殘影 → 點亮 → 畫線 → 封包流動 → 出現勾勾),然後硬切到下一個句子。它支援 9:16 與 16:9 兩種比例,適用於 AI 解說、概念解說或快速教學影片,且必須有旁白但無人物露面。標題為阿拉伯文,標籤則為英文單色大寫。整個流程高度自動化:透過 CLI 指令套用風格、使用預先建立的示範區塊、並利用 NX.js 動畫輔助程式庫(如 NX.ignite、NX.draw、NX.packet 等)來建構場景。色彩遵循品牌規範,每個顏色有固定角色(背景、表面、文字、強調色、角色色)。輸出前需通過 lint、快照與評審檢查,確保每個標題只有一個圖表、阿拉伯文標題正確從右到左排列,且不會出現未經允許的紫色或霓虹色。

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

在你喜歡的 AI 中提問

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

說明文件

風格:霓虹節點解說員

一個冷靜的科技解說:每句台詞一個標題,標題下方只有一個小型圖表,會逐步發光(暗淡殘影 → 點亮 → 畫線 → 封包跑動 → 出現勾勾),硬切到下一個句子。 卡片:video-projects/_library/styles/neon-node-explainer/style.md — 已核准 2026-10-02。

先看外觀(在風格資料夾中):frames/01-chain-ai-mcp-apis.png · frames/02-hub-fanout-tools.png · frames/03-terminal-steps.png。證明顏色遵循品牌的檔案:tests/2026-10-01-three-themes.jpg(不在公開儲存庫中)。

0. 先套用卡片

node tools/vid.mjs style apply neon-node-explainer <project> [--mode calm|punchy]
node tools/vid.mjs style show neon-node-explainer

然後閱讀工具組 README:video-projects/_library/assets/kits/node-explainer/README.md(零件、輔助程式、時間設定)。不要手工製作工具組已有的東西。

1. 顏色 = 角色(品牌定義十六進位色碼)

風格就是品質、結構與動態。絕不送出參考用的紫色或霓虹色,除非品牌規定如此。 用 NX.theme(root, …) 填入角色 — README 中的 "brandToNx" 區塊會將 brand/<name>.md 的欄位對應如下:

代號角色來自品牌
--nx-bg舞台(淺色會將工具組切換為淺色模式)畫布
--nx-surface / --nx-border卡片、極細線條表面 / 線條
--nx-text / --nx-dim文字文字-強 / 淡化
--nx-accent → --nx-accent-2僅用於標題中 1–3 個關鍵詞主要色 → 次要色(相同 = 平面)
--nx-role-1模型 / "大腦"主要色
--nx-role-2伺服器 / 連接器 — 線條、封包、弧線資訊色或次要色
--nx-role-3系統 / API第三色或主要色的淡色
--nx-role-4應用程式 / 客戶端表面色或白色
--nx-ok / --nx-warn / --nx-danger狀態(warn 也代表反白路徑)成功 / 警告 / 危險
已儲存的主題:neon(僅供參考 — 僅用於測試)、midnight、light(範例色板,非真實品牌)。其他所有顏色都是衍生而來的 — 絕不為每個品牌手動設定衍生顏色。一個顏色 = 整個影片的一個角色;品牌顏色較少時 → 重複使用主要色的淡色,不要發明新的色相。

2. 開始建構

  • 從示範區塊開始(複製 nx.css、nx.js、GSAP、DrawSVG、字體、2 個 UI 音效):
    node tools/vid.mjs use node-explainer-9x16 <project>     # _library/compositions/portrait/node-explainer-9x16.html(20 秒,5 個場景)
    node tools/vid.mjs use node-explainer-16x9 <project>     # _library/compositions/node-explainer-16x9.html(20.5 秒,6 個場景)
    
    將產生的 <div … data-composition-src=…> 連同 data-variable-values='{"theme":"<brand>"}' 插入 index.html。可比較的示範渲染檔:_library/styles/neon-node-explainer/tests/demo-9x16-20261001.mp4(不在公開儲存庫中)、demo-16x9-20261001.mp4。
  • 9:16 版面(1080×1920): 標題在上方(78 px,最多 2 行,text-wrap: balance),一個圖表居中放在標題下方;所有內容在 x 60–960、y 220–1500 範圍內。
  • 16:9 版面(1920×1080): 標題 66 px 在上方,圖表居中;文件、游標、軌跡與分割場景在 16:9 區塊中。
  • 場景: NX.scene(tl, el, in, out) = 硬切 · NX.headline = 整個在切畫格上 · 然後 NX.ignite / NX.draw / NX.packet / NX.check / NX.chip / NX.pill + NX.type / NX.term / NX.steps / NX.fanout / NX.cursor。每個輔助程式在你傳入的時間點加入動畫,並回傳結束時間。
  • 動畫時間代號(卡片 JSON): 殘影 0.1 秒 · 點亮 0.22 秒 · 線條 0.35 秒 · 封包 0.32 秒(線條的 10%)· 彈出 0.3 秒 back.out(1.7) · 建構步驟間隔 0.4–1.2 秒(配合語音)· 完成的圖表停留 0.5–1.5 秒 · 打字 25 字元/秒(僅限拉丁字母)。
  • 文字: 標題在切畫格時立即顯示(無淡入、無字母分開)· 單色大寫標籤以打字方式出現 · 終端機行以打字方式顯示,輸出滑動 10 px。
  • 轉場: 僅硬切;空白畫布 0.1–0.3 秒,然後開始建構。
  • 模式: calm = 標題約每 4 秒一個,無音效,發光 0.35 · punchy = 約每 2.5–3 秒一個,每個點亮部分有滴答聲,發光 0.5,封包跑兩次。
  • 音效: 旁白為主(−14 LUFS)。可選音效 _library/assets/sfx/gen/ui-tick.wav(不在公開儲存庫中)(點亮部分)和 ui-pop.wav(勾勾 / 點擊)以 0.22 / 0.28 作為靜態 <audio> 標籤。背景音樂僅在需要時使用:從 _library 音樂中選取安靜的墊底音,約 −24 LUFS。絕對不要生成音樂。

3. 在當事人看到之前的檢查

  1. npx hyperframes lint 在專案內執行 — 0 錯誤。
  2. npx hyperframes snapshot --at <每次建構結束> — 讀取每個畫格:每個標題對應一個圖表,沒有超出角色的內容。
  3. npx hyperframes render --quality draft → node tools/vid.mjs judge <draft.mp4> → 讀取 sheet.jpg 和 safe-sheet.jpg。
  4. 安全區 x 60–960、y 220–1500(9:16)。阿拉伯文標題需連字且從右到左,英文單字放在 .nx-ltr 範圍內,絕不逐字母打字,絕不分開字母,<html> 上不要有 dir="rtl"。
  5. 風格檢查:封面畫格(t=0)已顯示一個點亮的部分(全黑的封面會導致評審失敗);強調色僅用於 1–3 個關鍵詞;發光僅作用於活動中的部分。

注意事項

  • 要: 每句口說台詞一個標題,且只建構它提到的內容;英文單色大寫標籤,阿拉伯文標題;每個場景以可見部分或殘影開始;讓發光代表「活動中」。
  • 不要: 在不使用該紫色的品牌中送出參考紫色;一個標題下方有兩個圖表;背景發光、圓點或顆粒;打字顯示阿拉伯文;假裝終端機 / 工具列表是真實產品 UI。

工作完成後:node tools/vid.mjs style comment neon-node-explainer "<哪些地方有效或無效>"。

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

相關技能