Communitygithub.com

delorenj/skills

安裝 HyperFrames Registry 中的區塊與元件,並將其整合至 HyperFrames 組合。適用於執行 hyperframes add、安裝區塊或元件、將安裝項目接線至 index.html,或處理 hyperframes.json 之情境。涵蓋 add 指令、安裝位置、區塊子組合接線、元件程式碼片段合併及 Registry 探索。

skills 是什麼?

此技能專門用來管理 HyperFrames 生態系統中的可重用區塊(Blocks)與元件(Components)。當使用者執行 `hyperframes add <name>` 時,此技能會自動解析指令,理解安裝的是獨立的子組合(Block)或是純特效片段(Component),並提供後續的接線指引。安裝完成後,此技能不僅會記錄 CLI 回傳的檔案路徑與程式碼片段,還能進一步引導開發者將區塊透過 `data-composition-src` 屬性嵌入主組合,或將元件的 HTML/CSS/JS 片段合併到對應的宿主組成中。支援 `hyperframes add` 的標準選項,如 `--dir`、`--json`、`--no-clipboard`,並會根據 `hyperframes.json` 中的路徑設定決定安裝目錄。此技能涵蓋的場景包含:安裝並接線區塊與元件、探索 Registry 內容、在 CI/headless 環境中跳過剪貼簿。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/hyperframes-registry

在你喜歡的 AI 中提問

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

說明文件

HyperFrames Registry

Registry 提供可重用的區塊(Blocks)與元件(Components),可透過 hyperframes add <name> 安裝。

  • 區塊(Blocks) — 獨立的子組合(擁有自己的尺寸、時間長度與時間軸)。在主組合中透過 data-composition-src 引入。
  • 元件(Components) — 效果程式碼片段(無獨立尺寸)。直接貼入主組合的 HTML 中。

何時使用此技能

  • 使用者提到 hyperframes add、「區塊(block)」、「元件(component)」或 hyperframes.json
  • 對話中出現 hyperframes add 的輸出結果(檔案路徑、剪貼簿程式碼片段)
  • 你需要將已安裝的項目接線至現有組合
  • 你想探索 Registry 中有哪些可用項目

快速參考

hyperframes add data-chart              # 安裝區塊
hyperframes add grain-overlay           # 安裝元件
hyperframes add shimmer-sweep --dir .   # 指定目標專案
hyperframes add data-chart --json       # 輸出機器可讀格式
hyperframes add data-chart --no-clipboard  # 跳過剪貼簿(CI/無頭環境)

安裝後,CLI 會列印出已寫入的檔案以及一段可貼入主組合的程式碼片段。該片段是起點,你需要自行添加 data-composition-id(必須與區塊內部的組合 ID 相符)、data-start 與 data-track-index 屬性來接線區塊。

注意:hyperframes add 僅適用於區塊與元件。若要使用範例,請改用 hyperframes init <dir> --example <name>。

安裝位置

預設情況下,區塊安裝至 compositions/<name>.html。 元件安裝至 compositions/components/<name>.html。

可在 hyperframes.json 中設定這些路徑:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

完整說明請參閱 install-locations.md。

接線區塊

區塊是獨立的組合 — 透過 data-composition-src 在主組合的 index.html 中引入:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

重要屬性:

  • data-composition-src — 區塊 HTML 檔案路徑
  • data-composition-id — 必須與區塊內部的 ID 相符
  • data-start — 區塊在主組合時間軸中出現的時間(秒)
  • data-duration — 區塊播放的長度
  • data-width / data-height — 區塊畫布尺寸
  • data-track-index — 圖層排序(數值越大越上層)

完整說明請參閱 wiring-blocks.md。

接線元件

元件是程式碼片段 — 將其 HTML 貼入組合的標記中,CSS 貼入樣式區塊,JS 貼入腳本區塊(如果有的話):

  1. 讀取已安裝的檔案(例如 compositions/components/grain-overlay.html)
  2. 將 HTML 元素複製到組合的 <div data-composition-id="..."> 中
  3. 將 <style> 區塊複製到組合的樣式中
  4. 將任何 <script> 內容複製到組合的腳本區塊中(在時間軸程式碼之前)
  5. 如果元件公開了 GSAP 時間軸整合功能(請參閱程式碼片段中的註解區塊),將那些呼叫添加到你的時間軸中

完整說明請參閱 wiring-components.md。

探索

瀏覽可用項目:

# 讀取 Registry 資訊清單
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

每個項目的 registry-item.json 包含:名稱、類型、標題、描述、標籤、尺寸(僅區塊)、時間長度(僅區塊)以及檔案列表。

根據類型和標籤篩選的詳細說明,請參閱 discovery.md。

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

相關技能