Communitygithub.com

delorenj/skills

安装和配置 HyperFrames 组合中的注册表块和组件。适用于运行 hyperframes add、安装块或组件、将已安装项接入 index.html 或处理 hyperframes.json 时使用。涵盖 add 命令、安装位置、块子组合接线、组件代码片段合并以及注册表发现。

skills 是什么?

该技能用于管理 HyperFrames 框架的注册表,允许用户通过 `hyperframes add <name>` 命令安装可复用的块(独立的子组合)和组件(效果代码片段)。它详细说明了如何将安装的块通过 `data-composition-src` 属性接入宿主组合,并配置时间线相关的属性(如 `data-start`、`data-duration`、`data-track-index`);对于组件,则指导将 HTML、CSS 和 JS 片段直接粘贴到现有组合中。技能还涵盖了安装路径的配置(通过 `hyperframes.json`)以及使用 `curl` 浏览注册表发现可用项目。支持主要平台:HyperFrames 框架,适用于开发者在使用 CLI 管理动态组合时自动化接线和配置任务。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames 注册表

注册表提供了可通过 hyperframes add <name> 安装的可复用块和组件。

  • 块 (Blocks) — 独立的子组合(拥有自己的尺寸、时长和时间线)。通过宿主组合中的 data-composition-src 属性引入。
  • 组件 (Components) — 效果代码片段(没有自己的尺寸)。直接粘贴到宿主组合的 HTML 中。

何时使用此技能

  • 用户提及 hyperframes add、"block"、"component" 或 hyperframes.json
  • hyperframes add 的输出出现在会话中(文件路径、剪贴板代码片段)
  • 你需要将已安装项接入现有组合
  • 你想浏览注册表中可用的内容

快速参考

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。

接线块

块是独立的组合——通过宿主 index.html 中的 data-composition-src 属性引入:

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

发现

浏览可用项目:

# 读取注册表清单
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.

相关技能