Communitygithub.com

laviedezidane/hyperframes-skill

将任意文本——文章、笔记、主题、简报——转化为无面讲解视频:无需网站或实拍素材,视觉效果按场景创作(排版、抽象图形、图表、数据可视化)。

hyperframes-skill 是什么?

该技能旨在将用户提供的纯文本内容转换为“无面讲解视频”,即所有视觉效果均为按场景动态生成,无需预先采集网站或实物素材。它支持将文章、笔记、概念等转化为讲解视频、概念拆解、教程或列表类视频。技能工作流严格分为多个步骤:首先通过 `hyperframes init` 初始化项目并创建 `BRIEF.md` 确认需求;然后保存用户文本作为信息源,选择预设设计系统并生成 `frame.md`;接着基于叙事设计编绘图稿和脚本,运行审查循环;之后生成语音、时间戳和背景音乐;最后渲染多个帧 `NN-*.html` 并导出最终视频 `video.mp4`。全程强调“无面”特性,即无网站捕获步骤和真实资产清单,视觉效果均由脚本按帧创造。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/faceless-explainer

在你喜欢的 AI 中提问

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

文档

插件安装: 在运行设置或更新命令之前,若此技能位于 HyperFrames 插件内,请遵循插件执行规则。独立安装则保留下面的更新说明。

首先,保持技能新鲜——在运行前与用户确认: npx hyperframes skills update faceless-explainer。如果一切为最新版本则快速跳过;否则会刷新此技能及其依赖的核心领域技能。

媒体使用: 在获取音频/图像/标志之前,请调用 /media-use 来解决来自 HeyGen 目录的背景音乐/音效/图像以及来自官方来源的品牌标志。先运行 --adopt 注册现有资产。参见 /media-use 技能。如果宿主应用提供其自己的音乐或音效工具,则使用它们处理音乐和声音效果。

Faceless Explainer 到 HyperFrames

使用此技能将一段文本转化为讲解视频:选择设计系统,规划教学故事,并在 HyperFrames 中逐帧构建。无面意味着每个视觉都是后续创作的——没有捕获步骤,也没有真实资产清单。

入口是 /hyperframes。 你是编排者。执行每一步,验证其关卡,然后才继续。此技能用于从文本讲解主题,无产品无网站可捕获。任何其他意图、一个简单的“制作视频”请求或不确定 → 先阅读 /hyperframes——意图层拥有所有路由决策,并且一个新鲜创建者若在此处没有 BRIEF.md 也会经过该层(设置的开门规则)。

你是编排者。在 videos/<project>/ 目录下工作。按顺序执行步骤,在继续前通过每个关卡。用户关卡为步骤 0、步骤 3 和步骤 6。在步骤 0 之前阅读 ../hyperframes/references/brief-contract.md——它定义了关卡类型以及 BRIEF.md 的 flow/storyboard 如何导出控制步骤 3/4/6 关卡的 mode。除了步骤 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 导出 mode(简报契约 § 1)。(2) 无 BRIEF.md 但项目存在(磁盘上有 hyperframes.json/STORYBOARD.md)→ 从分镜的 frontmatter 和已记录偏好恢复;永不重新询问一个半建项目。(3) 两者均无——到达此处的全新创建请求 → 读取 /hyperframes 并运行其意图层(references/intent-interview.md):它检查配方和已记忆默认值,进行此路线的问题(../hyperframes/references/routes/faceless-explainer.md),并返回锁定的简报。编辑请求跳过所有这些——直接进行编辑。

仅在缺少 hyperframes.json 时初始化。从主题副标题式命名 <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 并逐字输出其结果。它会报告语音/背景音乐将使用 HeyGen 还是本地引擎,并且当未登录时,报告如何登录。应用一个分支:

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

当无离线提供者时不要静默忽略所需能力;呈现障碍。不要将此决定折叠到另一个问题中或将密钥写入每个仓库的 .env。认证所有权和离线回退:/media-use references/setup-providers.md § Providers。

关卡: 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 颜色/字体为空)→ 脚本保留预设自己的调色板,一个完整的可交付设计。仅在用户命名了品牌颜色/字体时将它们添加到 tokens.json 再运行,并且仅在映射确实需要时才随后手动调整 frame.md。

关卡: build-frame.mjs 退出 0——frame.md 来自命名预设,并且(当预设提供一个时).hyperframes/caption-skin.html 存在作为字幕皮肤源;所选预设已记录为偏好(--key style_preset --workflow <this 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。将 frontmatter duration: 设置为简报中 length 的值——一个大致的预期;装配会报告最终剪辑与之的差距。

使用 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>。管道默认值否则是 HeyGen 上的 Marcia(女性) / Kokoro 上的 am_michael——因此像“男性声音”这样的请求除非你传递标志否则会被静默忽略。语音 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 音乐库查找背景音乐以及时间元数据。背景音乐情绪来自分镜的 music: 字段。这使用 HeyGen 音频 API 进行检索,而非生成,并使用与 TTS 相同的 ~/.heygen 凭据。有关提供商详情,请阅读 ../media-use/audio/references/tts.md。当宿主应用自己的工具制作音乐或音效时,将文件放在 assets/ 下并在 audio_meta.json 中列出并标记 "source": "host":音乐作为 bgm { "path": "assets/…", "source": "host" },分镜中带有 music: none;音效作为 sfx 条目 { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <其长度>, "source": "host" }。每个音频通道都保留这些,并且带有宿主音效的帧不会获得查找提示。

如果没有叙述且没有 SCRIPT.md,跳过语音生成。如果分镜有音乐情绪,背景音乐仍可能运行。

规范的全静默标记(在重用此音频模型的工作流间共享):STORYBOARD.md 顶部 YAML 块中的 music: none,无 SCRIPT.md,并且无 sfx: 提示或宿主音频。该组合将项目标记为静默——当静默时,后续渲染通道

…(内容已截断)

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

相关技能