1实现原理 · 为什么它能做到

两条硬规则被明确标为「平台约束而非审美」：intro 仅 3–5s、logo 可读时刻 1–2s，超出会实测掉留存。

skills/youtube-intro-outro/SKILL.md

1. **Keep the intro 3-5s, the logo hit 1-2s.** Anything longer than 5s causes measurable viewer drop-off, which hurts the video in the algorithm.

这里在做什么：把「开场动画长度」从品味问题变成留存成本问题，于是片头被压缩成一次快速确认而不是一个小作品。

第二条硬规则同样来自平台机制：结束页元素只允许出现在最后 5–20s，且视频总长必须 ≥25s。

skills/youtube-intro-outro/SKILL.md

YouTube only allows end-screen elements in the final 5-20s, and the video must be at least 25 seconds long.

这里在做什么：outro 的时长（~20s 保持画面）不是风格选择，而是「给可点击元素留家」的最小值；视频不到 25s 时 end screen 直接不可用。

logo sting 被拆成 windup → impact → settle 三拍，并要求品牌标记精确落在音频最强瞬态那一帧。

skills/youtube-intro-outro/SKILL.md

The brand mark must land exactly on the sound's impact frame, not near it.

这里在做什么：把「高级感」定位到一个单点约束（音画同帧）——reference 还给了在波形图上找瞬态、再换算成 IMPACT = Math.round(t × fps) 的方法。

snap 的制作方式是 spring 从 1.18 过冲到 1，加 6 帧白闪衰减。

skills/youtube-intro-outro/SKILL.md

`spring` overshooting from 1.18→1 *is* the snap; the white `flash` decaying over 6 frames sells the impact.

这里在做什么：用两个可调参数（过冲起点、闪光衰减帧数）复现「贵」的观感；impact 默认固定在 0.8s 附近，与 sting 的瞬态对齐。

outro 版式的核心是二分法：YouTube 的点击元素占右侧三分之二，自有品牌只能待在左三分之一。

skills/youtube-intro-outro/SKILL.md

YouTube's clickable elements live on the **right two thirds**; keep your own branding, channel name, and any face-cam in the **left third**.

这里在做什么：这是大多数 outro 翻车的地方——把 logo 或文字放在 YouTube 将要盖 subscribe 按钮的位置。skill 用「分区 + 原生尺寸」把冲突前置排除。

元素原生尺寸被写死（订阅圈 294×294、下一个视频卡 615×345），并按这些尺寸在版式里画虚线占位框。

skills/youtube-intro-outro/SKILL.md

| Next-video card (thumbnail) | 615×345 | upper-right or center-right |

这里在做什么：先按占位框构图，再在 Studio 里把真元素对上；reference 给了 16:9 的 ASCII 坐标图与「最多 4 个元素、1 卡 + 订阅是最高点击率布局」的经验结论。

guides 只在预览构建里出现，成片必须丢掉，右侧刻意留白。

skills/youtube-intro-outro/SKILL.md

Ship the dashed guides only in a preview build; the final render drops them, leaving a clean plate whose right side is intentionally quiet.

这里在做什么：把「设计辅助」与「交付物」分离；reference 用 prop 开关实现同一组件的两种输出。

两个 composition 共用一个 brand prop（name/logo/sting/bg/fg/accent），没有任何硬编码品牌信息。

skills/youtube-intro-outro/SKILL.md

Both compositions read a single `brand` prop — no hardcoded names, colors, logos, or audio.

这里在做什么：把「换品牌」收敛成换一个 JSON；reference 给出 brand 类型与批量循环（`for f in brands/*.json` → 每品牌出 intro+outro 两条片）。

验证必须专门检查 impact 帧（logo 满格 + 白闪衰减中），并要求成片去掉虚线参考框。

skills/youtube-intro-outro/SKILL.md

Verify the **impact frame** explicitly (logo snapped to full, white flash decaying) — the sting must land *on* it, not near it.

这里在做什么：把最容易差之毫厘的环节（音画同帧）设为独立验收项，而不是夹在三张静帧里顺手一看。

2核心能力

013–5s 品牌片头（windup / impact / settle 三拍，spring 过冲 + 白闪，sting 混入）

02outro / end-screen plate：左三分之一品牌区 + 右三分之二留白（含虚线占位框，可开关）

03元素坐标与尺寸规范（16:9 坐标图、订阅圈 294×294、视频卡 615×345、最多 4 个元素、最高点击率＝1 卡 + 订阅）

04音频瞬态对齐方法：在波形图上找最强瞬态 → 换算 IMPACT 帧号（或反过来裁音频）

05CSS/GSAP 版 logo sting（无 Remotion 的备选实现）

06品牌模板化 + 批量：一个 brand.json 驱动 intro/outro，一循环出多频道成片

07Shorts（9:16）变体指引：原生 end screen 不可用，需把订阅/看下一个烤进画面并靠口播 CTA

08交付-验证回路：windup / impact / settle 与 outro plate 静帧 + probe-mp4 规格断言 + 成片去 guides

3外部依赖

Kind	Dependency / Endpoint
cli	npx remotion still / render / compositions
cli	scripts/contact-sheet.sh + scripts/probe-mp4.sh（仓库根共享验证工具箱，SKILL.md 明列）
cli	批量循环：`for f in brands/*.json` + basename 派生输出名（reference §7）
package	ffmpeg / ffprobe（系统依赖）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: （SKILL.md 明列的验证回路）`npx remotion still Intro out/i-{windup,impact,settle}.pn
网络端点: 声明外部网络访问: `npx remotion …`：首次执行经 npm 官方渠道取包与 CLI（registry.npmjs.org，域名由 npm 决定，源码未硬编码
本地工作目录: 文件读写与工件输出: agent 按本 skill 构建的 Remotion 工程与 out/intro.mp4、out/outro.mp4（批量为 out/<brand>

审计说明： 。三段自证：① 判级对象＝skills/youtube-intro-outro/（find 确认只有 SKILL.md、references/intro-outro.md 与一个 0 字节 README，零脚本、零资产）；② 目录内自身行为＝本地读取素材（logo/sting）与本地写入（Remotion 工程、out/*-intro.mp4、out/*-outro.mp4、静帧、sheet.png）＋本地 CLI（`npx remotion`；ffmpeg/ffprobe 经仓库根 scripts/），skills/ 全域 `process.env` / `api[_-]?key` / `token` / `cookie` / `https?://` 均 0 命中；③ 唯一网络面是 npm 官方渠道取包（remotion / @remotion/*），与站内蓝档先例（hyperframes、general-video、motion-background）同口径。不升黄/橙：无固定公开端点查询、无抓取、零凭据/环境变量读取、零素材外发——本 skill 不接 YouTube API，也不上传任何内容到平台（发布由用户自己在 Studio 完成）。非红档：无 TLS 降级、无沙箱关闭、无反自动化绕过、无任意代码执行面。需另记（不改档）：平台门槛（3-5s intro、≥25s 总长、end screen 仅最后 5-20s）是外部规则，skill 只做提示与 probe-mp4 可测的部分（时长/规格），是否合规最终由用户负责。

5第二遍独立确认

[ok] 平台时间常数在 SKILL.md 与 reference 是否一致（防一手数据两处不同） — SKILL.md：intro 3-5s、logo hit 1-2s、end-screen 只允许最后 5-20s、视频 ≥25s、outro plate 保持 ~20s；reference 表："logo hit 1-2s"、"Whole intro | 3-5s max"、"End-screen window | last 5-20s"、"Outro plate hold | ~20s"、"Minimum total video length | 25s"。两处逐值对应，无矛盾。
[ok] 元素尺寸与数量上限是否两处一致 — SKILL.md 给 Subscribe/channel circle 294×294、Next-video card 615×345、Playlist/link card 294×294，并在输出清单写「Up to 4 end-screen elements planned (1 video + 1 subscribe is the highest-CTR layout)」；reference 元素表同值（615×345 / 294×294 / 294×294）并写 "| Max elements | 4 | highest CTR layout = **1 video card + subscribe**, nothing else |"。一致。
[discrepancy] Shorts（9:16）场景的覆盖是否存在缺口（第一遍只读 SKILL.md 会漏） — SKILL.md 的硬规则 2 是无条件表述：「The outro must be ≥20s of held, quiet layout, and the video ≥25s total.」并未提 Shorts 例外；而 reference §1 明确写 "for Shorts use a 2-3s end card and a verbal CTA instead of native end-screen elements (Shorts do not support them)"，§5 另设「9:16 (Shorts) note」。结论：只读 SKILL.md 的 agent 可能给一条 45 秒的 Short 设计 20 秒 outro，直接吃掉整片——这是对 pin commit 有效的真实覆盖缺口（信息存在于 reference，未上提到 SKILL.md 的硬规则）。
[unlocatable] 「Anything longer than 5s causes measurable viewer drop-off」是否有据 — SKILL.md 与 reference 都以肯定语气给出留存影响（"retention drops measurably"），但仓库内无引用来源、无数据集、无链接；本次为只读侦查，不验证该断言，仅记为文档声明。平台机制部分（5-20s 窗口、≥25s 门槛）属 YouTube 公开规则，可信度高但仍未附官方链接。
[ok] brand prop 是否真的无任何硬编码（防「模板化」空口宣称） — SKILL.md 的 LogoSting 与 EndScreen 组件里，颜色/字体/logo/sting 全部取自 `brand.bg` / `brand.fg` / `brand.accent` / `brand.logo` / `brand.sting`（仅字体族在示例里写 "700 56px Inter" 这类样式串）；reference §7 定义 Brand 类型与 brands/pixelforge.json 示例，并强调 "Keep fonts, sizes, timing, and layout fixed in the components — only `brand.json` changes." 与 SKILL.md 的宣称一致。
[ok] impact 帧对齐方法是否可操作（而非只喊「要对齐」） — reference §4 给出四步：「Open the sting in any waveform view… The impact is the tallest transient」「Read its time in seconds, e.g. 0.78s」「Set `IMPACT = Math.round(0.78 * fps)` and make the logo's `opacity`/`scale` snap key fall on that frame.」「If you can't move code, instead trim the audio so its transient sits at your fixed `IMPACT` (e.g. 0.8s)」。方法具体、可执行，且给了代码侧与音频侧两种收敛方向。
[ok] 验收与交付是否覆盖「guides 不得进成片」 — SKILL.md 写 "Ship the dashed guides only in a preview build; the final render drops them"，verify 段亦要求 "Drop the dashed end-screen guides for the final render; verify the right two-thirds is intentionally quiet."；reference §6 用 prop 开关实现同一组件的两种输出。纪律 + 机制 + 验收三处齐备（但仍是纪律而非强制渲染开关）。

6结论

把片头/片尾从审美问题变成平台约束问题：3-5s、1-2s、最后 5-20s、≥25s 都被写成硬规则并给出理由

「贵」被拆成单点约束 + 两个可调量：logo 与 sting 瞬态同帧、spring 1.18→1 过冲、6 帧白闪

outro 版式按平台 UI 分区（左三分之一自有、右三分之二留给 YouTube），并用原生元素尺寸做占位框，把冲突排除在设计阶段

模板化彻底：单个 brand prop 驱动两个 composition，一批品牌循环出片，20 个频道保持结构一致

验收把最容易差之毫厘的 impact 帧单列，并要求成片去掉虚线 guides——防止设计辅助混进交付物

reference 补齐边界：CSS/GSAP 无 Remotion 变体、Shorts 9:16 例外、瞬态找帧方法、brand schema

适合： 适合：YouTuber/频道运营者搭建一次性的品牌片头与结束页模板，然后逐频道换 brand.json 复用；也适合需要保证「YouTube 点击元素不被自家版式挡住」的团队（这是最容易出错且最容易量化的一环）。适合愿意在波形图上读数、接受「impact 帧单独人眼验收」的流程。

不适合： 不适合：① 只做 Shorts 的创作者直接照抄硬规则 2（应先看 reference 的 Shorts 例外，改用 2-3s 结束卡 + 口播 CTA）；② 想自动化端屏元素摆放的人——Studio 里的对齐仍须手动；③ 需要多语言/多画幅同时出片的复杂品牌体系（本 skill 只覆盖 16:9 intro/outro，9:16 仅一段说明）；④ 要求「品牌资产自动适配」（自动裁 logo、自动剪辑 sting）的场景——这里要求资产本身已就绪；⑤ 想用平台 API 发布或抓取数据的人（本 skill 完全不接 YouTube API）。

Install Agent-Ready

① Verified Mirror 2026-09-28

Option A · Direct DownloadDownload youtube-intro-outro.tar.gz

sha256: 9f3a594d22ab4694…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit f3df381d65.