Communitygithub.com

muhammedadnank/Antigravity-Skills

将一段5–15秒的短视频转化为全屏滚动驱动电影式着陆页,用户滚动时逐帧播放视频,并叠加5段戏剧性文字场景,打造沉浸式视差体验。

Antigravity-Skills 是什么?

该技能(Parallax Landing Page)专为将短视频片段转化为电影级滚动驱动着陆页而设计,属于YUV.AI技能体系中的中层组件。它接受一个5–15秒的MP4输入,通过FFmpeg以`-q:v 2`质量提取每一帧为HD JPEG(每帧约120–220 KB),然后生成一个单一视口的HTML页面:页面本身禁用滚动,所有滚轮/触摸/键盘输入被JavaScript截获并转换为虚拟帧进度,用户通过滚动手势逐帧浏览视频画面。同时,5段精心编排的文字场景(包括Kicker、大写Anton标题、Caveat手写点缀)在预设的进度窗口内淡入淡出,形成完整的叙事节奏。该技能内置了从参考示例(如`examples/parasites/`目录下的github、lion、hope着陆页)中验证的模式,并严格遵循Anton + Caveat + Inter字体栈和独特的金/琥珀/粉/奶油色调色板,不与YUV Design System冲突。它支持两种工作模式:独立创建新文件夹或整合到已有的展示画廊中。最终产出一套包含帧文件夹、HTML文件、共享CSS和JS的完整文件结构。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/muhammedadnank/Antigravity-Skills/tree/HEAD/skills/parallax-landing-page

在你喜欢的 AI 中提问

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

文档

视差着陆页

将一段短视频转化为单屏电影式着陆页,用户通过滚动手势逐帧浏览视频,同时5段戏剧性文字场景淡入淡出。文档本身不会实际滚动——所有滚轮/触摸/键盘输入在JavaScript中被截获并转换为虚拟帧进度。

本技能封装了在参考示例(位于../../examples/parasites/ —— 使用此技能构建的三个工作页面:github、lion、hope)中验证的模式。如有任何歧义,请以该文件夹为准。

本技能在YUV.AI体系中的位置

parallax-landing-page 位于YUV.AI技能体系的中层,与 yuv-design-system、yuv-decks、yuv-viral-video、video-to-landing-page并列。高层编排器 yuv-pilot 每当需要将一段5–15秒的视频片段转化为单屏滚动式着陆页时,会路由到此技能。

本技能自带视觉语言(Anton + Caveat + Inter,金/琥珀/粉/奶油色调色板)——它不会调用 yuv-design-system。两个系统共存:yuv-design-system 负责网页/应用/演示表面的品牌调色板,而 parallax-landing-page 专门负责电影级滚动刮擦美学。对于YUV.AI视差着陆页,你可以选择性地在页脚区域添加Phoenix水印和规范Linktree URL作为品牌贯穿线——水印文件见 yuv-design-system/assets/。不要将Anton/Caveat字体栈替换为设计系统的Neon调色板——这会丢失标志性外观。

你将要构建的内容

每个着陆页都是一个锁定视口,包含:

  • 一个全屏画布,每次绘制一帧(cover-fit,DPR ≤ 2)
  • 5个绝对定位的文字场景(kicker + 大写Anton标题 + Caveat手写行),每个有独立的滚动进度窗口
  • 一个固定的导航栏,包含 PARALLAX // showcase 标志和指向兄弟着陆页的链接
  • 一个加载器,在允许用户交互前预加载所有帧
  • 一个暗角 + 胶片颗粒叠加层
  • 一个底部滚动提示,用户开始滚动后淡出
  • 一个右下角帧计数器(例如 073 / 145)
  • 最后一个场景即是CTA区域——没有单独的 .end 部分

总大小(q:v 2时):约120–220 KB/帧 × 帧数。6秒24fps片段 = 145帧 ≈ 25 MB。10秒片段 = 241帧 ≈ 53 MB。

保存位置

默认: ~/Documents/yuv-projects/landings/<slug>/ —— 始终将独立着陆页保存在此处,以便日后查找。仅在用户明确指定其他位置或选择了模式B(整合到现有的 examples/parasites/ 展示画廊)时覆盖。

mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 技能在此创建 <slug>/ 文件夹,并在其中提取帧和构建HTML

最终路径(模式A —— 独立):~/Documents/yuv-projects/landings/<slug>/。 最终路径(模式B —— 整合):用户选择的现有展示目录。

每次构建完成后告诉用户最终路径。


工作流程

共有四个阶段。不要跳过任何阶段——每个阶段都是下一阶段的输入。

阶段1 —— 发现

向用户确认:

  1. 视频路径 —— 源MP4文件位置。
  2. Slug —— 简短的文件夹/文件名(例如 hope、marcus、desk)。单个单词,小写,无空格。它既是帧文件夹名称(<slug>/),也是HTML文件名(<slug>.html)。
  3. 主题/话题 —— 这个着陆页是关于什么的?产品发布?个人时刻?野生动物邂逅?你需要这些信息来撰写文案。
  4. 项目模式 —— 独立(全新文件夹)还是整合到 examples/parasites/(此仓库顶层)的现有展示画廊中。如果用户说“把它添加到展示画廊”,他们指的是模式B。
  5. 强调色 —— 用于脚本/CTA高亮:gold(#f5b042)、amber(#ff8a3d)、accent(粉色 #ff4d6d)、cream(#f5e9d4),或者其他新颜色(将其添加到 :root 的style.css中,并编写新的 .script.<name> 规则)。

如果用户未指定其中某些项,请提出默认值并继续——不要因为用户在看到结果后就能回答的问题而停滞不前。

阶段2 —— 提取帧

运行捆绑的提取脚本。它会使用ffprobe探测视频,并以原始分辨率用 -q:v 2(近乎无损JPEG)提取每一帧,命名为 frame-001.jpg 到 frame-NNN.jpg(3位零填充)。

python <skill>/scripts/extract_frames.py <video_path> <output_folder>

示例:

python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
    C:/Users/User/Documents/parasites/hope/hope.mp4 \
    C:/Users/User/Documents/parasites/hope

脚本向stdout输出一个JSON元数据块。捕获它——你需要 frame_count 和 suggested_scroll_budget 用于HTML。

为什么用 -q:v 2:ezgif等工具重新压缩非常激进(约55 KB/帧)。原生ffmpeg在q:v 2时,相同尺寸下每帧约120–220 KB——明显更清晰。不要缩小;永远不要放大(会无谓增大文件,不增加细节)。

为什么用滚动预算公式(约26像素/帧):保持跨片段长度的“每次滚动前进的像素数”恒定。145帧 → 约4200,241帧 → 约6300,90帧 → 约2500(下限)。脚本为你计算并限制在 [2500, 8000] 范围内。

阶段3 —— 编写页面

读取 <skill>/assets/landing-page-template.html 模板。它是一个完整的可工作文件,包含 {{PLACEHOLDER}} 标记和创意部分旁边的 <!-- TODO: --> 注释。在 <target>/<slug>.html 写入新文件,替换所有内容。

替换检查清单(每个占位符都必须被替换):

占位符填入内容示例
{{PAGE_TITLE}}HTML <title>Hope — 内盖夫最快的猎手
{{PAGE_DESCRIPTION}}meta描述,一句话与Midbarium的猎豹Hope共度的时刻。
{{SLUG}}文件夹名称(无路径,无斜线)hope
{{FRAME_COUNT}}整数帧数241
{{FRAME_COUNTER_TEXT}}宽度匹配的 001 / NNN001 / 241
{{SCROLL_BUDGET}}提取器JSON中的整数6300
{{PREVIEW_FRAME_MID}}零填充的中间帧121
{{PREVIEW_FRAME_END}}零填充的最后一帧241
{{LOADER_TITLE}}一个单词,大写HOPE
{{LOADER_SCRIPT}}以 … 结尾的手写行召唤奔跑者…
{{NAV_LINKS_HTML}}导航的完整 <a> 标签块见下文
{{SCENE_N_*}}每个场景的kicker、标题、手写行(共5个场景)见文案指南
{{SCROLL_HINT_TEXT}}2–4个大写单词提示滚动奔跑
{{CTA_BUTTONS_HTML}}2–4个 <a class="cta"> 标签见下文
{{ACCENT_CLASS}}用于 .script.X 和 .cta.X 的强调色后缀amber

阅读 references/copy-guide.md 了解电影式文案模式(kicker措辞、标题长度、手写行语气)。文案是本技能的价值所在——通用文案会毁掉一个精美的动画。

阶段4 —— 配置资源

如果目标文件夹已经包含 style.css 和 parallax.js(展示画廊整合),则无需操作——它们是共享的。否则,将两者从 <skill>/assets/ 复制到目标文件夹:

cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js

如果整合到现有展示画廊,还需执行 references/showcase-integration.md 中的步骤——向 index.html 添加卡片,在每个现有着陆页的导航栏中添加链接,并在前一个着陆页的最终场景中添加链式CTA。

告知用户如何查看:

从父文件夹通过 python -m http.server 8000 打开 <target>/<slug>.html(不要使用 file://——Chromium可能会因本地图片源导致画布脏)。

文件约定

<target>/
├── <slug>/                  # 帧文件夹
│   ├── <slug>.mp4           # 源文件(保留)
│   ├── frame-001.jpg
│   ├── frame-002.jpg
│   └── … frame-NNN.jpg
├── <slug>.html              # 着陆页
├── style.css                # 共享(独立时复制)
├── parallax.js              # 共享(独立时复制)
└── index.html               # 枢纽页(仅独立或整合时需要)

帧文件夹名称和HTML文件名必须使用相同的slug——页面中 new ParallaxPage({folder: '<slug>', ...}) 调用的 folder 选项就是字面的文件夹路径。

ParallaxPage API(已在parallax.js中,请勿重新定义)

new ParallaxPage({
  folder:       '<slug>',     // 包含frame-001.jpg等的文件夹
  frameCount:   145,          // 整数
  prefix:       'frame-',     // 此技能始终为 'frame-'
  scrollBudget: 4200,         // 完成一次完整遍历所需的累计输入像素
  // 可选:padWidth(默认3),ext(默认 'jpg')
})

该类会自动附加 body.scrub-page(通过CSS锁定滚动)、预加载所有帧、运行基于RAF的lerp(因子0.22)朝向滚动衍生的目标帧,并淡入淡出其 data-start/data-end 范围包含当前进度的场景。

硬约束(不可协商)

这些已融入参考实现,违反会破坏体验:

  • 5个场景,固定进度窗口:0.00–0.20、0.22–0.40、0.42–0.60、0.62–0.80、0.82–1.00。场景之间的0.02间隙是故意为之——让用户在每个节拍之间“只看到图像,没有文字”。英雄场景(场景1)和最终场景(场景5)分别使用 data-fade="0.30" 和 data-fade="0.18",以便在边缘保持更长时间;中间场景使用默认的0.25。
  • 滚动刮擦区域下方没有 .end 部分。最终场景包含CTA。整个页面是一个锁定视口。
  • Anton + Caveat + Inter——大写Anton用于所有粗体文字,Caveat用于手写点缀(金/琥珀/粉/奶油色),Inter用于任何正文引导文本。永远不要替换,永远不要添加第四种字体。
  • 近白色 #f5f1ea,永远不是 #fff——已在CSS中定义为 var(--text)。
  • 帧名称格式为 frame-NNN.jpg,零填充到总帧数的位数(标准是3位,因为片段小于1000帧;JS会根据总数自动计算计数器宽度)。
  • slug既是文件夹名称,也是HTML文件名的基础名——hope/、hope.html。没有例外;整合步骤依赖此约定。

遇到困难时的参考位置

  • 此仓库中捆绑的参考展示:examples/parasites/ —— github.html、lion.html、hope.html、style.css、parallax.js、index.html。如果你的输出在视觉上与这些页面有显著差异,说明你偏离了方向;重新阅读。
  • references/copy-guide.md —— 如何编写5个场景使其真正具有电影感。
  • references/showcase-integration.md —— 添加到现有枢纽时需要进行的精确编辑。
  • assets/landing-page-template.html —— 带有占位符的规范结构。
  • assets/hub-template.html —— 仅在创建全新展示画廊时使用(从头构建3个卡片)。

两个真实调用示例

独立模式: 用户有一个片段 desk.mp4,想要一个着陆页。

  1. 询问slug和主题。对 desk.mp4 运行提取器 → ./desk/frame-NNN.jpg。
  2. 将 style.css + parallax.js 复制到项目根目录。
  3. 根据模板编写 desk.html。导航栏只有一个链接:自身。
  4. 完成。告知用户使用 python -m http.server 提供服务。

展示画廊添加: 用户将 hope.mp4 添加到现有的 parasites 文件夹。

  1. Slug = hope。提取 → hope/frame-NNN.jpg。(重用现有 style.css + parallax.js。)
  2. 根据模板编写 hope.html。
  3. 执行展示画廊整合:向 index.html 添加第三个卡片,在 github.html 和 lion.html 的导航栏中添加 Hope 链接,在前一个着陆页的最终场景中链式添加 下一步:Hope → CTA。
  4. 如果引入新的强调色,将其添加到 :root 中,并在 style.css 中添加 .script.X + .cta.X 规则。

Individual skills in this repo

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

muhammedadnank/Antigravity-Skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language and any subject. The signature effect is mouse-driven video scrubbing \u2014 the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing -> joy -> nostalgia -> contemplation -> action). Do NOT use for parallax frame-scrub landings where the page itself doesn't scroll (use parallax-landing-page instead) or for video editing / captioning workflows (use video-edit).

muhammedadnank/Antigravity-Skills

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

muhammedadnank/Antigravity-Skills

Best practices for Remotion - Video creation in React

muhammedadnank/Antigravity-Skills

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

muhammedadnank/Antigravity-Skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

相关技能