Communitygithub.com

samyakiasonline-ctrl/hyperframe

将任意文本——文章、笔记、主题、概要——转化为无讲解人出镜的解说视频:无需真实网站或素材,每一场景的视觉效果(排版、抽象图形、图表、数据可视化)均为自动生成。适用于主题解说、概念拆解、操作指南、列表式内容。

hyperframe 是什么?

该技能可将纯文本内容自动转化为无真人出镜的解说视频,适用于主题解说、概念拆解、操作指南和列表式内容。它利用 HyperFrames 框架进行逐帧构建,所有视觉元素(排版、抽象图形、图表、数据可视化)均在后期自动生成,无需实际网站或素材。工作流程包括配置项目、提取文本信息、选择设计预设、规划故事板和脚本、生成基于 HeyGen 的语音和音乐(若需)、为每帧添加视觉设计方向,并最终合成为视频。该技能支持协作模式和自主模式。在自主模式下,流程自动推进;在协作模式下,会在关键里程碑(如故事板审核和最终渲染前)暂停以征求用户反馈。关键依赖包括 `../hyperframes/references/brief-contract.md`(用于门控定义)和 `../media-use` 技能(用于音频源和品牌标志管理),确保系统提示与项目约束保持一致。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/faceless-explainer

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行设置或更新命令之前,请遵循插件执行规则(当该技能位于 HyperFrames 插件内部时)。独立安装请保留以下更新说明。

首先,保持该技能最新——在运行前请与用户确认: npx hyperframes skills update faceless-explainer。如果一切为最新版本,则为快速空操作;否则,它将刷新该技能及其依赖的核心领域技能,然后再使用它们。

媒体使用: 在获取音频/图片/标志之前,调用 /media-use 从 HeyGen 目录解析 BGM/SFX/图片,并从其官方来源获取品牌标志。先运行 --adopt 以注册现有资产。参见 /media-use 技能。

无讲解人出镜解说 转 HyperFrames

使用此技能将一段文本转换为解说视频:选择一个设计系统,规划教学内容,并在 HyperFrames 中逐帧构建。无讲解人出镜意味着每个视觉元素都是在后期生成的——没有捕获步骤,也没有真实的资产清单。

入口是 /hyperframes。 你是编排者。运行每个步骤,验证其门控,然后才继续。此技能适用于通过文本解释一个主题,没有产品也没有要捕获的网站。任何其他意图,仅仅“制作视频”,或任何不确定性 → 首先阅读 /hyperframes——意图层拥有所有路由决策,并且如果没有 BRIEF.md,新创建也会经过它(设置的首要规则)。

你是编排者。在 videos/<project>/ 目录下工作。按顺序运行步骤,并在继续之前通过每个门控。用户门控步骤为第 0 步、第 3 步和第 6 步。在第 0 步之前阅读 ../hyperframes/references/brief-contract.md——它定义了门控类型以及 BRIEF.md 的 flow/storyboard 如何派生模式,该模式控制第 3/4/6 步的门控。除第 5 步(你为每帧分派一个子代理)外,其余步骤均由你亲自完成。不要在此处放置设计或动画规则;这些规则位于帧工作者子代理、该技能的本地 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ 以及 hyperframes-creative 中。

工作流程:第 0 步设置 → hyperframes.json;第 1 步概要 → capture/extracted/;第 2 步设计系统 → frame.md;第 3 步故事板/脚本 → STORYBOARD.md 和 SCRIPT.md;第 3.1 步音频 → audio_meta.json;第 4 步视觉设计 → 增强的 STORYBOARD.md;第 5 步帧 → compositions/frames/NN-*.html 和 index.html;第 6 步最终渲染 → renders/video.mp4。


第 0 步:设置

目标:带着已确认的概要进入,创建 HyperFrames 项目,并使概要持久化。

概要是由意图层确认的,而非在此处提问获得。 首要规则,按顺序:(1)BRIEF.md 存在 → 阅读它,不提问任何问题——概要已确定,其 flow/storyboard 派生模式(概要合同 § 1)。(2)无 BRIEF.md 但项目存在(磁盘上有 hyperframes.json / STORYBOARD.md)→ 从故事板的元数据和已记录的首选项继续;绝不对已构建一半的项目重新提问。(3)两者都不存在——直接到达此处的新创建请求 → 阅读 /hyperframes 并运行其意图层(references/intent-interview.md):它会检查配方和记忆的默认值,执行此路由的问题(../hyperframes/references/routes/faceless-explainer.md),并返回锁定的概要。编辑请求跳过所有这些——直接进行编辑。

仅在缺少 hyperframes.json 时初始化。从主题中以 kebab-case 命名为 <project>,例如 compound-interest-explained;绝不使用工作区名称或时间戳。

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer——init 检查已安装的技能与 GitHub 上的最新版本,并更新任何过时的全局技能集。

初始化后,让 <PROJECT_ROOT> 为 videos/<project>,并在该目录下运行每个后续的相对路径命令。在以下命令中,. 表示 <PROJECT_ROOT>;绝不将 .media、capture 或输出文件写入调用者目录。

初始化后立即编写 BRIEF.md(绝不在之前——init 会拒绝非空目录):意图层锁定的概要,格式遵循 ../hyperframes/references/brief-format.md。将 <MEDIA_DIR> 解析为已安装的 /media-use 技能目录。然后使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 记录每个偏好支持的答案(brief-format.md 标明了子集)。如果意图层采用了配方,则运行 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>;它会将配方的 frame.md 复制到项目中(第 2 步将被跳过),并返回第 3 步起草所依据的框架。配方填写答案,不填写批准;审查门控仍会运行。

在继续设置之前显示登录状态——运行 npx hyperframes auth status 并逐字转发其输出。它会报告语音/BGM 将使用 HeyGen 还是本地引擎,以及当未登录时如何登录。应用一个分支:

  • 协作模式: 等待用户登录或显式选择 offline / go。
  • 自主模式: 说明状态并通过可用的本地引擎继续。

当没有离线提供商时,不要静默忽略必需的能力;暴露阻塞点。不要将此决策合并到另一个问题中,或将密钥写入每个仓库的 .env。认证所有权和离线回退:/media-use references/setup-providers.md § 提供商。

门控: hyperframes.json 和 BRIEF.md 存在;偏好支持的答案已记录(概要合同 § 2);登录状态已显示(已登录,或继续离线)。


第 1 步:概要(无捕获)

目标:将用户的文本作为信息来源纳入项目。没有网站捕获也没有真实资产——这是一个无讲解人出镜的解说。

逐字保存用户的完整输入,然后手动创建合成捕获包:

  • capture/extracted/visible-text.txt——完整的文章/笔记/主题/概要,逐字保留。这是信息的来源,而非故事模板(第 3 步会重新塑造它)。
  • capture/extracted/tokens.json——{ "title": "", "description": "", "colors": [], "fonts": [] }。根据概要填写 title/description。除非用户明确提供了品牌颜色或字体,否则将 colors/fonts 保留为空——若提供了则添加(设计预设无论如何都会提供完整的调色板)。

如果用户粘贴了脚本或希望保留其措辞,请将其逐字保存为 user_script.txt;VO_MODE(逐字或重构)来自 BRIEF.md——当脚本到达时,意图层会询问此问题。仅在概要明确缺失时才在此处询问一次,并将答案存储以供第 3 步使用。

不要运行 npx hyperframes capture(没有 URL)。不要创建 asset-descriptions.md 或填充 capture/assets/——无讲解人出镜的视觉元素在第 4-5 步中生成,而非捕获。唯一的例外:如果用户提供了真实图片,将其放置在 public/<basename> 下,并告知第 3 步。

门控: capture/extracted/visible-text.txt 和 capture/extracted/tokens.json 存在;你能用一句清晰的话说明解说器的主题和受众。


第 2 步:设计系统

目标:选择一个已发布的帧预设;一个脚本将其转换为该视频的 frame.md + 字幕皮肤。

当 BRIEF.md 指定了 style_preset——用户在意图层通过示例展示集视觉选择——则使用它;只有在概要不明确时,判断权才归于你。然后你做出唯一的选择——哪个预设:阅读 ../hyperframes-creative/references/design-spec.md 并浏览 ../hyperframes-creative/frame-presets/;选择外观最符合主题、语气和受众的预设。然后运行:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

脚本会确定性地完成其余工作:将预设的 FRAME.md 复制到 frame.md 并重新混合到 capture/extracted/tokens.json 中的任何品牌标记上(品牌颜色按角色映射到预设的颜色键;预设的显示字体和正文字体替换为品牌的),将预设的字幕皮肤复制到 .hyperframes/caption-skin.html,并进行自我验证(映射损坏时退出 1)。一旦退出 0 即可继续——无需手动编辑规范。

无讲解人出镜的解说通常没有品牌颜色/字体(tokens.json 的 colors/fonts 为空)→ 脚本将保留预设自己的调色板,这是一个完整可交付的设计。仅当用户指定了品牌颜色/字体时,才在运行前将其添加到 tokens.json,并且仅在必要时手动调整 frame.md。

门控: build-frame.mjs 退出 0——frame.md 来自一个已命名的预设,并且(当预设附带时).hyperframes/caption-skin.html 作为字幕皮肤源存在;所选预设已记录为首选项(--key style_preset --workflow <此工作流>,概要合同 § 2)。


第 3 步:故事板和脚本

目标:将文本转换为一个经批准的逐帧教学计划。

阅读 ../hyperframes-creative/references/story-spine.md(钩子语言、价值先于证据、故事板作为提案、来源可追溯的视觉元素)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/script-format.md。使用它们编写 STORYBOARD.md,并在需要旁白时编写 SCRIPT.md。根据概要的 length 设置元数据 duration:——这是一个粗略的预期;组装步骤会报告最终长度与其的对比。

使用 story-design.md 获取解说器结构(概念/操作指南/列表/故事)、钩子策略、清晰度技巧、情感节律、类型枚举映射和 VO_MODE。视频的顺序来自叙事设计,而非输入文本的段落顺序——可以重新排序、合并、省略、压缩。作为软性指南,参考 ../hyperframes-animation/blueprints-index.md 中的角色→蓝图菜单:对于每个节律,以其候选蓝图暗示的形状编写画外音,并在合适时标记该候选 blueprint: id。教学真实性仍然决定哪些节律存在——绝不强行让节律适合蓝图,也不仅仅因为有一个已知的形状可用而发明一个节律。无讲解人出镜的视觉元素是在后期生成的,因此帧不携带资产清单:除非用户提供了真实的 public/<basename> 图片,否则将 asset_candidates 留空。使用故事板和脚本参考中要求的精确字段。

起草后,运行审查循环的计划步骤——../hyperframes/references/review-loop.md § 1:将计划作为提案呈现,并提出两个问题——批准或修改,以及是否先做草图(推荐)或跳过。反馈通过聊天回复进行;循环直到获得批准。这是一个检查点门控(概要合同 § 1):在自主模式下,无需提问——发布相同的摘要作为预告,并继续;草图合并到构建中,最终的预览及其一个问题在第 6 步进行。

门控: STORYBOARD.md 存在,每帧都包含必需的叙事字段,需要旁白时 SCRIPT.md 存在,并且用户批准了逐帧计划(自主模式:已发布摘要作为预告)。


第 3.1 步:音频

目标:根据批准的脚本生成旁白、单词时间戳、音乐和音频元数据。

在第 3 步批准后开始音频。在后台运行它,然后继续第 4 步。(登录状态已在第 0 步显示;引擎会自动回退。)

在调用前根据用户要求选择旁白语音。 如果请求指定了语音、性别或语气,选择一个匹配的语音 ID 并传递 --voice <id>。管道默认值否则为 Marcia(女性)(HeyGen)/ am_michael(Kokoro)——因此像“男性声音”这样的请求如果你不传递标志则会被静默忽略。语音 ID 因提供商而异;根据第 0 步登录状态选择的提供商进行解析:HeyGen(已登录)通过 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(或 GET /v3/voices?engine=starfish);Kokoro(离线)通过 <MEDIA_DIR>/audio/references/tts.md 中的语音表(前缀 am_/bm_ 为男性,af_/bf_ 为女性)。当用户未表达任何偏好时,在管道默认值之前回退到记忆的语音(概要合同 § 2),并说明你使用了哪一个;仅当两者都未指定时省略 --voice。当用户此次运行显式选择了语音时,记录下来(prefs.mjs record --key voice)。

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &

音频脚本处理旁白、单词时间戳、来自 HeyGen 音乐库的 BGM 查找以及时间元数据。BGM 情绪来自故事板的 music: 字段。这使用 HeyGen Audio API 进行检索而非生成,以及相同的 ~/.heygen 凭据作为 TTS。有关提供商详细信息,请阅读 ../media-use/audio/references/tts.md。

如果没有旁白且没有 SCRIPT.md,则跳过语音生成。如果故事板有音乐情绪,BGM 仍可能运行。

规范的全静默标记(在重用此音频模型的工作流中共享):STORYBOARD.md 顶部 YAML 块中的 music: none 并且没有 SCRIPT.md。该组合将项目标记为静默——无旁白、无 BGM、无 SFX。audio.mjs 会识别它并生成任何内容(它会移除任何过时的 audio_meta.json;assemble 将缺失的 audio_meta.json 视为静默),因此此步骤是一个干净的跳过。music: none 与旁白一起保留 TTS 并仅关闭 BGM。请精确使用此拼写——不要发明其他标记。

门控: 音频作业已启动,或者项目已标记为静默(music: none + 无 SCRIPT.md)。


第 4 步:帧视觉设计

目

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

samyakiasonline-ctrl/hyperframe

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

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, timeline, history, clean, 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.

samyakiasonline-ctrl/hyperframe

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. Read before writing composition HTML.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

samyakiasonline-ctrl/hyperframe

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also 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).

samyakiasonline-ctrl/hyperframe

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

samyakiasonline-ctrl/hyperframe

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

相关技能