Communitygithub.com

9018/mychat: 网站转视频 (Website to HyperFrames)

捕获一个普通网站/URL,将其转化为 HyperFrames 视频(网站导览、展示或源自网站自身视觉效果的社交媒体短片)。

mychat: 网站转视频 (Website to HyperFrames) 是什么?

该技能旨在帮助用户将一个普通网站(如作品集、博客或落地页)转化为专业视频,适用于网站导览、功能展示或社交媒体短片等场景。它通过一系列预定义的工作流程(共7步)实现,包括网站捕获与品牌理解、品牌标识提取、策略与信息对齐、故事板与脚本创建、配音与字幕生成、画面合成构建,以及最终的验证与交付。技能支持自主模式(autonomous mode),但关键的质量验证步骤(如资产审计、逐拍HTML审查、完成度检查清单和诚实披露部分)即使在自主模式下也不可跳过。该技能专注于“普通网站”场景,与针对产品营销推广的 /product-launch-video、无网站的主题讲解 /faceless-explainer、GitHub PR 转视频 /pr-to-video 等技能有明确路由区分。用户在意图不明确时,建议先阅读 /hyperframes 技能以获取完整路由表。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.agents/skills/website-to-video

在你喜欢的 AI 中提问

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

文档

media-use:在获取音频/图片素材前,请先调用 /media-use 以从HeyGen目录中获取BGM/SFX/图片。首先运行 --adopt 以注册现有资产。详情请参阅 /media-use 技能。

网站转 HyperFrames 视频

捕获一个网站,然后从中生成专业视频。

在步骤0之前确认路线。 此技能制作的是_用于 / 源自一个普通网站_的视频。如果用户实际上是营销 / 发布 / 推广一个产品(即使是从此URL,即使是“我们网站的推广视频”)→ 请使用 /product-launch-video。没有网站的主题讲解 → /faceless-explainer;GitHub PR → /pr-to-video;对现有视频文件进行重新剪辑/重新调色/重新排序 → 超出范围。如果用户只是模糊地说“制作一个视频”,或者不确定是产品发布还是普通网站?请先阅读 /hyperframes(完整路由表 + § HyperFrames 不能做什么)。

用户经常这样说:

  • “把这个网站变成一个15秒的Instagram社交短片”
  • “从 https://... 制作一个30秒的网站导览/展示视频”
  • “捕获我们的首页,并用它自己的视觉效果构建一个视频”

工作流程包含7个步骤。每个步骤都会产生一个工件作为下一个步骤的先决条件。默认情况下是协作式的——标记为 💬 的关卡会停下来询问用户。如果用户指定了自主模式(“替我做决定”,“给我惊喜”),则跳过 💬 用户偏好关卡;详见 step-2-brief.md 了解其传播方式。

自主模式并不意味着“跳过所有关卡”。 自主模式涵盖了用户偏好问题(TTS提供商、声音、色彩强调、节拍数、是否使用音乐、是否使用字幕——由AI代理代表用户做决定)。它不涵盖质量验证关卡。以下关卡在自主模式下仍不可跳过:

  • 资产审核(步骤3)——查看联络表并为每个资产论证使用/跳过的原因
  • 逐拍HTML审查(步骤5)——每个节拍的证据块
  • 完成度检查清单(步骤6)——包括动画映射、每个警告的WCAG验证、音频/运动回放
  • 诚实披露部分(步骤6)——“我未验证的内容”必须出现在您的最终摘要中

如果您发现自己认为“自主模式倾向于行动,所以我会跳过X”——而X是一个验证关卡,而不是一个偏好问题——那么这个推理是错误的。倾向于行动适用于决定_构建什么_,而不是决定_是否验证_。


步骤0:捕获与理解品牌

阅读: references/step-0-capture.md

捕获网站,然后阅读提取的数据以理解品牌和产品——它做什么,为谁服务,用什么声音说话,处于什么情绪中。捕获的资产是以后使用的品牌工具包,而不是视频的构建块。

在简要说明之前显示登录状态——运行 npx hyperframes auth status 并逐字转发其输出(不要改写或重新表述)。 它会报告语音/BGM将使用HeyGen还是本地引擎,以及当未登录时,如何登录。如果未登录,请停止并等待用户选择——登录,或说“go”/“offline”以继续使用本地引擎——然后再询问简要说明或其他任何事情。 将其视为一个真正的决策点,而不是一个附注;不要将选择折叠到简要说明问题中,也不要将密钥写入每个仓库的 .env 文件中。(在自主模式下,记录状态并继续使用离线模式。)请参阅 ../hyperframes-media → Preflight 获取权威指导。

关卡: 输出网站摘要——先策略(产品做什么,为谁服务,品牌声音),然后是资产/颜色/字体清单;已显示登录状态(已登录,或继续使用离线模式)。


步骤1:品牌标识

阅读: references/step-1-design.md

编写 DESIGN.md ——一个涵盖视觉标识的品牌速查表:颜色、排版、组件样式、布局原则。使用 design-styles.json 获取精确的计算值。

速度选项: 对于快节奏视频(每拍一个广告牌),DESIGN.md 可以是一个包含颜色+字体+注意事项的50行摘要——而不是300行的文档。步骤5中的子代理提示会直接粘贴品牌值,因此DESIGN.md的深度仅对复杂合成有意义。

关卡: DESIGN.md 存在(任何长度),至少包含:色调板、字体选择和注意事项。


步骤2:策略与信息传递

阅读: references/step-2-brief.md, references/capabilities.md(扫描目录——仅在需要时深入阅读具体章节)

在讨论视觉效果或资产之前,先与用户就视频必须传达什么信息达成一致。解析用户的提示——他们可能已经告诉您视频类型和风格。只问缺失的内容:这个视频必须说的一件事、叙事弧线和受众。

关卡: 视频类型、持续时间、格式以及——关键地——信息和叙事弧线已锁定。没有这些,步骤3无法编写概念优先的分镜脚本。


步骤3:分镜脚本 + 脚本 💬

阅读: references/step-3-storyboard.md

按概念优先编写分镜脚本:信息 → 叙事弧线 → 服务弧线的节拍 → 每个节拍的技术 → 最后进行品牌色彩润色。然后编写匹配的旁白脚本。向用户展示两者,并附上逐拍摘要。迭代直到用户批准。

关卡: STORYBOARD.md + SCRIPT.md 存在并且用户已批准该方案。


步骤4:配音、时间与字幕 💬

阅读: references/step-4-vo.md

如果步骤2确定不需要旁白——询问背景音乐,然后跳到步骤5。否则:询问用户选择哪种TTS提供商(HeyGen TTS、ElevenLabs 或 Kokoro),生成音频,转写,将时间戳映射到节拍。然后询问字幕。

关卡: 要么 (a) 未要求旁白且分镜脚本有手动节拍时间,要么 (b) narration.wav + transcript.json 存在且节拍时间已使用实际时长更新。


步骤5:构建合成画面

阅读: hyperframes 技能(加载它——每一条规则都很重要) 阅读: references/step-5-build.md

按照分镜脚本(步骤3)中选择的架构和节奏构建 index.html 和合成画面。子代理在报告之前对每个节拍运行 hyperframes lint 和 hyperframes snapshot。

关卡: 每个 compositions/beat-N.html 都已由主代理从头到尾对照 DESIGN.md 和 STORYBOARD.md 阅读。逐拍检查清单位于 step-5-build.md 中。


步骤6:验证与交付

阅读: references/step-6-validate.md

进行 lint、验证、根据视频长度(公式:max(节拍数 × 3, ceil(持续时间秒数 / 2)))缩放快照数量并审查每一个。在交付前修复问题。交付 localhost Studio 项目URL——仅在用户明确要求时才渲染为MP4。仅在交接时提供该Studio URL——它是最终、稳定的预览;构建阶段的快照是 headless 的,因此不要在构建过程中弹出预览。

交付一个您引以为豪的作品。 在交出之前,问问自己:我会把这个作品发布到社交媒体并署上我的名字吗?如果不会,请修复问题。

关卡: npx hyperframes lint 和 npx hyperframes validate 通过且零错误,并且最终响应中包含活动的 Studio 项目 URL。


快速参考

视频类型

各视频类型的典型约束——作为起点,而非公式。节拍数应由内容和旁白决定,而不是由目标范围决定。

类型典型时长时长驱动因素旁白
社交广告 (IG/TikTok)10–15秒平台限制可选
产品演示30–60秒脚本长度完整旁白
功能公告15–30秒功能复杂度完整旁白
品牌短片20–45秒音乐轨道可选,以音乐为主
发布预告片10–20秒钩子能量最少

本表格中故意未包含节拍数——它应当来自分镜脚本,而不是“社交广告 = 3-4个节拍”。一个复杂产品的社交广告可能需要5个节奏恰当的节拍。而一个拥有一个强大视觉主题的品牌短片可能只需要3个。

格式

  • 横屏:1920x1080(默认)
  • 竖屏:1080x1920(Instagram Stories, TikTok)
  • 正方形:1080x1080(Instagram 信息流)

参考文件

文件何时阅读
step-0-capture.md步骤0——捕获、理解品牌和产品,编写策略优先的网站摘要
step-1-design.md步骤1——编写 DESIGN.md 品牌速查表(5个部分,250-350行;广告牌风格的社交广告可使用50行快速路径)
step-2-brief.md步骤2——与用户就信息、叙事弧线和受众达成一致
capabilities.md步骤2和5——HyperFrames 能做什么的完整清单(24个部分)。在简要说明期间扫描目录,在构建期间深入阅读特定部分
step-3-storyboard.md步骤3——分镜脚本 + 脚本(合并),带有用户审查关卡
step-4-vo.md步骤4——TTS提供商选择、生成、时间安排
step-5-build.md步骤5——构建 index.html + 合成画面
step-6-validate.md步骤6——lint、验证、快照(按视频长度缩放)、预览
techniques.md步骤3和5——13种基本动画技术及代码模式(参考借鉴,不要复制粘贴)
html-in-canvas-patterns.md步骤5——HTML-in-Canvas 效果的完整代码模式(位于 hyperframes 技能中)

Individual skills in this repo

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

9018/mychat

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

9018/mychat

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

9018/mychat

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

9018/mychat

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

9018/mychat

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

9018/mychat

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

9018/mychat

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

9018/mychat

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

9018/mychat

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

9018/mychat

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

9018/mychat

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.

9018/mychat

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

9018/mychat

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

9018/mychat

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

9018/mychat

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

9018/mychat

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

9018/mychat

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

9018/mychat

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

相关技能