Communitygithub.com

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

将一个通用网站/URL 抓取并转化为 HyperFrames 视频(站点导览、展示或基于站点自身视觉素材的社交媒体短片)。适用于意图为通用的场景(博客/落地页展示或社交媒体切片)。不适用于:产品/SaaS 发布或推广(→/product-launch-video,即使从 URL 开始);话题解说且无网站(→/faceless-explainer);GitHub PR(→/pr-to-video);为已有视频添加字幕(→/embedded-captions);短篇无旁白页面高亮动态图形(→/motion-graphics)。不确定是发布还是通用站点?先问一个问题或从 /hyperframes 开始。

S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer- 是什么?

该技能(S.A.R.A.L.)旨在将任意通用网站转化为专业级 HyperFrames 视频,如站点导览、展示或社交媒体剪辑。其核心工作流程包含7个步骤,从 Step 0 的站点抓取与品牌理解开始,依次经过品牌标识设计(DESIGN.md)、策略与消息对齐、故事板与脚本共创、语音与字幕生成、构图构建,直至最终验证交付。技能严格区分了“通用站点视频”与“产品发布视频”(应使用 /product-launch-video)、“话题解说”(/faceless-explainer)等场景,并在入口处提供了明确的路线选择指引。工作流默认是协作式的,包含用户偏好确认(如TTS提供商、语音、调色方案、音乐/字幕开关)和质量验证关卡(如资产审计、逐节HTML检查、交付清单),即使在“自主模式”下,质量验证门也不可跳过。所有步骤均依赖详细的参考文档(位于 references/ 目录下),确保输出的视频在消息传递、叙事弧、视觉风格和技术实现上保持一致性和高质量。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/website-to-video

在你喜欢的 AI 中提问

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

文档

media-use: 在获取音频/图片前,先调用 /media-use 从 HeyGen 目录中解决背景音乐/音效/图片。先运行 --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 提供商、语音、颜色强调、节拍数、音乐是/否、字幕是/否——即由代理代表用户做决定)。它不涵盖质量验证关卡。以下关卡在自动模式下仍不可跳过:

  • 资产审计(步骤 3)——查看联系表并为每个资产论证使用/跳过理由
  • 逐节 HTML 读取(步骤 5)——每个节拍的结构化证据块
  • 交付清单(步骤 6)——包括动画映射、逐警告的 WCAG 验证、音频/动态播放
  • 诚实披露部分(步骤 6)——“我没有验证什么”必须出现在你的最终总结中

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


步骤 0:抓取与理解品牌

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

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

在简报前显示登录状态——运行 npx hyperframes auth status 并逐字转述其输出(不要转述或重写)。 它会报告语音/背景音乐将使用 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

检查代码、验证、拍摄缩放至视频时长的快照(公式:max(节拍数 × 3, ceil(时长_秒 / 2))),并逐一审查每个快照。在交付前修复问题。交付 localhost Studio 项目 URL——仅在用户明确要求时渲染为 MP4。仅在交接时展示该 Studio URL——它是最终、稳定的预览;构建阶段的快照是无界面的,因此不要在构建过程中弹出预览。

交付一个你引以为豪的作品。 在交接前,问问自己:我会把这个发布在社交媒体上并署上自己的名字吗?如果不是,修复有问题的地方。

关卡: 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——检查代码、验证、快照(缩放至视频时长)、预览
techniques.md步骤 3 和 5——13 种原始动画技术及其代码模式(应适应使用,而非复制粘贴)
html-in-canvas-patterns.md步骤 5——Canvas 内 HTML 效果的完整代码模式(位于 hyperframes 技能中)

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

相关技能