Communitygithub.com

SJbuilds04/vybe-typography

运动图形中的排版——字体系统、字体配对、视频可读性规则、动态排版技术、逐字母/单词动画、字幕设计与安全区域,适用于 HyperFrames 合成。在 VYBE 视频中选择字体、调整大小或为文字添加动画,构建动态排版或歌词视频,设计字幕,或处理文字重叠、裁剪、不可读或样式单调时使用。

vybe-typography 是什么?

**VYBE 排版** 技能为视频中的文字动画提供了一套完整的排版系统,涵盖字体选择、可读性规则、动态排版技术和字幕设计。该技能内置了 6 种开源(OFL)字体,包括 Inter、Space Grotesk、Fraunces、JetBrains Mono、Anton 和 Orbitron,并为每种字体提供了字重、特性和适用场景的详细说明。它规定了严格的视频可读性规则,例如最小字号为短边尺寸的 2.6%(1080p 下约 28px),保持时间约为每字 0.3 秒加 0.5 秒,以及对比度需满足 WCAG AA 标准。技能还提供了丰富的动态排版技术,如模糊到清晰、缩放冲击、遮罩上升、中心向外揭示等,并支持逐词同步字幕,包括安全区域、高亮词和样式建议。该技能集成在 HyperFrames 框架中,适用于 Claude Code、Cursor、Codex 等 AI 编码代理,通过 `vybe` CLI 命令和 `hyperframes check` 工具实现自动化排版审计。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SJbuilds04/VYBE/tree/HEAD/skills/vybe-typography

在你喜欢的 AI 中提问

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

文档

VYBE 排版

在动态图形中,文字通常是主角。将其视为视频素材:它有重量、尺度、节奏和摄像机角度。

内置字体(OFL 许可,位于 vybe/assets/fonts/,每个项目自动复制)

字体家族字符风格适用场景
Inter(可变字重 100–900)中性、精确苹果极简、企业、UI、字幕
Space Grotesk(300–700)技术、奇特科学、实验、科技
Fraunces(可变衬线)温暖、文学、高对比度电影、纪录片、编辑
JetBrains Mono(100–800)代码、数据标签、数字、终端风格
Anton(400,压缩)响亮、海报动态排版、社交媒体钩子
Orbitron(可变)科幻展示赛博朋克标题(仅适用于短词)

每个命名字体家族都需要在使用它的文件中使用 @font-face { src: url("assets/fonts/<file>.woff2") }(HyperFrames 会检查)。用户品牌字体:将文件复制到 assets/fonts/ 并以相同方式声明;检查其许可证是否允许嵌入。

字体配对: Fraunces + Inter(电影感)· Inter + JetBrains Mono(产品/技术)· Space Grotesk + JetBrains Mono(科学)· Anton + Space Grotesk(社交/动态)· Orbitron(仅限标题)+ Space Grotesk(其他所有内容)。

视频可读性规则(由 hyperframes check 工艺审计强制执行)

  • 最小阅读尺寸:短边的 2.6% → 2.7cqmin(1080p 下约 28px)。 正文 2.8–3.4cqmin;标题 6–12cqmin;主词 15–34cqmin。
  • 保持时间 ≈ 每字 0.3 秒 + 0.5 秒;结束行 ≥ 2 秒。
  • 一个场景中每秒屏幕上的字数 ≤ 3.2;每行字数 ≤ 约 10 词。
  • 对比度 WCAG AA(正文 4.5:1,大文本 3:1)。在图像上方时,添加遮罩或阴影。
  • 正文中不使用 <br>;使用 max-width(例如 78cqw)并让其自动换行。 展示标题可以使用块级 <span> 每行断行。
  • 字间距:收紧大标题(−0.02 到 −0.05em),张开小型大写标签(+0.2 到 +0.5em)。切勿动画化 letter-spacing(会突变)—— 使用 x 属性展开字符。
  • 安全区域:竖屏视频将阅读文字保持在顶部 12%、底部 22% 和右侧 14% 之外。

动态排版技术

技术方法
模糊到清晰将单词放入内联块 span,使用 fromTo {opacity:0, y:30, filter:blur(14px)},错开 0.12–0.16 秒
缩放冲击每拍一字,scale 2.4 → 1 配合 back.out(1.6),背后颜色区域翻转
遮罩上升行包装器 overflow:hidden,内部文字 yPercent 110 → 0
中心向外揭示clipPath: inset(0 50% 0 50%) → inset(0)
字形扩散每字母 x 偏移向中心收缩至 0
打字机效果clipPath 使用 steps(n) 缓动,或逐字符透明度设置
轮廓回声复制单词并添加 -webkit-text-stroke,透明填充,偏移拖尾
文字作为镜头缩放/旋转整个单词堆叠穿过画面进入下一场景
单词交换将两个单词堆叠在一个固定盒子中;yPercent 将旧的移出、新的移入
高亮内联块 .hl span 配合 back.out 缩放,或在其后放置标记条 scaleX 0→1
数字递增tabular-nums + onUpdate 写入 Math.round(v)

字幕(逐词同步)

vybe audio 注入 <script type="application/json" id="vybe-captions"> 提示({start, end, text, words:[{text,start,end}]}),每个 VYBE 模板都包含一个字幕构建器,为每个提示创建一个元素,并在转录的 start 时间点亮相应单词。按品牌样式:

  • 放置于安全区域内,位于下三分之一图形之上,绝不遮挡主体。
  • 每个提示 3–6 个单词,最多 2 行,字号 3–3.4cqmin,字重 600+,加遮罩或阴影。
  • 高亮当前单词(透明度 0.45 → 1,或通过类名使用强调色)。
  • 社交媒体风格:大写、加粗、每个提示弹出缩放;电影感:句子大小写、微妙的淡入淡出。
  • 绝不使用估计的单词时间轴进行字幕;行级时间轴必须看起来是行级的。

Individual skills in this repo

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

SJbuilds04/vybe-audio-design

Sound design and music direction for VYBE / HyperFrames videos — choosing music by mood and arc, spotting sound effects to picture, voiceover direction and provider choice (HeyGen, ElevenLabs, Kokoro, Gemini), ducking, loudness targets, beat-synced editing and caption sync. Use when planning or fixing the audio of a video, when a video feels silent, cheap, cluttered or out of sync, or when choosing a voice or music provider.

SJbuilds04/vybe-cinematic-3d

Deterministic Three.js / WebGL for HyperFrames videos — 3D scenes, particle systems, procedural geometry, product turntables, scientific models (molecules, planets, black holes), lighting rigs, camera paths and camera cuts, rendered frame-exactly from HyperFrames time. Use when a VYBE storyboard calls for 3D, depth, particles, space, a rotating product, a data sculpture, or when a Three.js layer renders black, flickers or differs between renders.

SJbuilds04/vybe-image-to-motion

Animate a still image into video. Analyzes the image, plans the motion, and picks the right technique — programmatic 2.5D (camera moves, depth-map parallax, subject/background layer separation, particles, fog, light) or AI image-to-video (Runway Gen-4.5 / Veo 3.1 / Kling 3.0, Luma Ray 3.2, Gemini Omni Flash) for organic motion like walking, faces, water or hair — then composes the result in HyperFrames with music, SFX and text. Use when someone supplies an image and asks to animate it, bring it

SJbuilds04/vybe-motion-design

Motion design craft for VYBE / HyperFrames videos — animation principles, easing and timing, choreography and staggering, scene transitions, camera movement, and visual effects (blur, glow, masks, grain, light leaks), written as seek-safe GSAP recipes. Use when designing or fixing how things move in a video — entrances, exits, transitions between scenes, camera moves, rhythm, or when motion feels generic, floaty, stiff or repetitive.

相关技能