Communitygithub.com

Drama2557/4RealDigital-Video-Studio

超大 macOS 游標技術,用於 HyperFrames 啟動影片。當場景涉及游標或指標引導動作、啟動 UI 場景、觸發變形/轉場/打字動畫,或場景顯得靜態、死板時,載入此腳本以提供低成本、高回報的視覺動態,引導觀眾視線並擺脫停滯狀態。涵蓋游標尺寸/外觀(包括品牌主題游標)、離屏進入法則、尖峰定位與點擊、點擊觸發下一個節拍,以及退出/跨場景移交。

4RealDigital-Video-Studio 是什麼?

Drama2557/4RealDigital-Video-Studio 是一個專門為 HyperFrames 啟動影片設計的 AI 助手技能,其核心是使用超大 macOS 風格游標作為視覺主角,引導觀眾視線。該技能的核心價值在於提供一種低成本、高回報的動態解決方案:當場景靜態、死板或需要啟動 UI、觸發動畫時,一個從螢幕外進入的超大游標可以有效地抓住並引導觀眾注意力,並透過點擊動作無縫觸發下一階段內容。此技能支援所有 HyperFrames 專案,並透過詳細的 SKILL.md 文件定義了嚴格的設計規範,包括游標尺寸(全螢幕不小於 7cqw)、離屏進入法則、尖峰定位(以箭頭尖端為準)及點擊壓縮動畫、點擊觸發下一節拍(確保點擊總是有所對應),以及物理退出或曲線移交的退出法則。此技能還特別支援品牌主題游標(如 Figma 風格的多人箭頭),可在不改變核心規則的情況下注入品牌辨識度。開發者使用此技能時,只需遵循其定義的 CSS 樣式、GSAP 動畫參數及檢查清單,即可快速產出高品質的動態影片序列。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/oversized-cursor

在你喜歡的 AI 中提問

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

說明文件

超大游標——視線載體

一個刻意放大的 macOS 風格指標,以「可見主角」的姿態在畫面中移動:從螢幕外進入,引導觀眾視線到下一關注點,點擊觸發後續事件,然後離開。經多個發布影片實戰驗證。

為何存在。 在發布影片中,大幅游標移動是成本最低但回報最高的動態來源之一:單一元素、純變形動畫,它能夠 (1) 在原本靜止的場景中引導視線穿越螢幕,(2) 為形變/轉場提供因果觸發(「是這個點擊造成的」),(3) 在啟動新場景或複雜動畫序列時,幫助視線從停滯狀態中脫離。越大越好——實際大小的游標在影片比例中會消失。

尺寸與外觀(團隊慣例)

  • 全螢幕場景:7cqw(約 134px,以 1920 為基準)。在模擬器/小畫面變體中:4.6–5.5cqw。絕不小於此。
  • 統一使用一個 SVG 箭頭幾何形狀。兩種經過驗證的填充方案——白色本體 + 黑色描邊,或黑色本體(#1c1c1c)+ 白色描邊(1.4px)。根據場景對比度選擇,並在整部影片中保持一致。
  • 品牌主題游標(強力玩法)。 macOS 箭頭是預設值,而非強制規定。當主題品牌具有可識別的游標識別——例如協作設計工具的彩色多人箭頭附有名牌(Figma 風格)、創意套件的精確十字準星、或獨特的產品指標——請改用該游標:對於熟悉該產品的人來說,這是即時可讀的品牌語言。相同法則不變(超大尺寸、實體進出、尖峰定位、點擊觸發),而帶名牌的變體作為一個剛性整體移動(名牌跟在箭頭後)。僅當該主題確實可被參照時才使用;無人識別的游標只是個奇怪箭頭——請退回使用 macOS 預設。
  • filter: drop-shadow(0 4px 6px rgba(0,0,0,.3))、pointer-events: none、z-index 高於所有場景內容、will-change: transform。
#root .cursor {
  position: absolute;
  left: 48%;
  top: 115%; /* 螢幕外下方——休息位置本身就在螢幕外 */
  width: 7cqw;
  height: 7cqw;
  z-index: 20;
  filter: drop-shadow(0 4px 6px rgba(0, 0, 0, 0.3));
  pointer-events: none;
  will-change: transform;
}

進入法則——物理性,永不原地揭露

游標永遠從螢幕外進入(一般慣例:從下方,top:115–120%),並以一次減速滑行移動到第一個目標。它必須讓人感覺像是「走進了房間」。絕不能以不透明度淡入的方式在靜止位置出現,也絕不能使用遮罩揭露——這看起來像故障(這是一個真實且反覆觀察到的失敗模式)。

  • 預設路徑:沿 Y 軸直線向上到達目標——沒有零碎的對角線。當對角線本身就是故事的一部分時(例如向偏軸目標進入)也可以使用,但無論如何都是一條連續的向量。
  • duration: 0.4–0.92s、ease: power3.out、immediateRender: false 用於 fromTo 動畫。
tl.fromTo(
  cursor,
  { left: "48.6%", top: "115%" },
  { left: "48.6%", top: "55%", duration: 0.85, ease: "power3.out", immediateRender: false },
  0.25,
);

尖峰定位與點擊觸碰

熱點是箭頭尖端,而非盒子中心。將尖端對準目標中心,並將所有按壓縮放以尖端為軸心:transformOrigin: '21% 14%'(適用於 24 單位 viewBox 中的團隊箭頭路徑)。

點擊 = 不對稱的壓縮/擴張(1:2 比例看起來像真實觸碰):

tl.to(cursor, { scale: 0.84, duration: 0.1, ease: "power2.in", transformOrigin: "21% 14%" }, t);
tl.to(
  cursor,
  { scale: 1, duration: 0.22, ease: "power2.out", transformOrigin: "21% 14%" },
  t + 0.1,
);

目標的反應是獨立且平行的補間動畫(按鈕:scale: 0.94 + 按壓顏色/陰影,與 t 同時開始)。僅游標點擊(例如聚焦文字輸入框)則無目標反應。與 cursor-click-ripple / press-release-spring 搭配用於目標側。

點擊觸發下一個節拍

絕不讓形變、打字動作、視窗變形或場景定義動畫自行開始。將游標停在觸發點上,讓點擊在同一幀內引發它:

  • 點擊 ▸ 選單/子選單層級、切換翻轉
  • 點擊 ▸ 觸發輸入框打字
  • 點擊 ▸ 編輯器形變縮小 / 視窗縮小
  • 點擊 ▸ Logo 點亮 / 飛行動畫啟動
  • 點擊 ▸ 產品模擬器中播放狀態切換 + UI 生命喚醒

在游標不主導的長節拍期間(打字、旁白),游標漂移到一旁(0.5–0.9s,power2.out)——絕不凍結在動作上方,也不無意義地晃動。

退出法則與跨場景移交

兩種經批准的退出方式——皆為物理性移動,絕不原地不透明度淡出:

  1. 離開畫面:以 power2.in 加速朝向最近的邊緣離開(left:'118%'、left:'-12%' 或 top:'116%'),0.5–0.7s。
  2. 曲線切割移交:在硬切換前的最後約 0.3s,游標開始加速(power2.in)朝向下一個場景的第一個點擊點,覆蓋該路徑的前約 1/3;下一個合成畫面的 gsap.set 將游標設定在移交姿勢,並以匹配的速度繼續 power2.out。游標本身成為縫合接縫的載體元素:
// 場景 A,最後 0.3s——開始旅程:
tl.to(cursor, { left: "40.7%", top: "63.7%", duration: 0.3, ease: "power2.in" }, CUT - 0.3);
// 場景 B,t=0——以匹配的速度完成:
gsap.set(cursorB, { left: "40.7%", top: "63.7%" });
tl.to(cursorB, { left: "22%", top: "45%", duration: 0.6, ease: "power2.out" }, 0);

檢查清單

  • 全螢幕 ≥ 7cqw(模擬器內 4.6–5.5cqw)——不確定時,越大越好
  • 從螢幕外以一條連續向量進入(無淡入/遮罩揭露)
  • 尖端落在目標中心;按壓以 transformOrigin: '21% 14%' 為軸心
  • 每次點擊都在同一幀內觸發某件事
  • 在不主導的節拍期間漂移到一旁;零無意義晃動
  • 以物理方式退出(離開畫面或曲線切割移交)——不原地淡出

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Drama2557/4RealDigital-Video-Studio

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

Drama2557/4RealDigital-Video-Studio

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Drama2557/4RealDigital-Video-Studio

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

Drama2557/4RealDigital-Video-Studio

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Drama2557/4RealDigital-Video-Studio

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Drama2557/4RealDigital-Video-Studio

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

Drama2557/4RealDigital-Video-Studio

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

Drama2557/4RealDigital-Video-Studio

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

相關技能