Communitygithub.com

MattiaIppoliti/tia-skills

创建或编辑自定义 HyperFrames 作品,适用于无专门工作流或 BRIEF.md 设置 flow: companion 的场景。用于长/多场景片段、品牌和精彩集锦、蒙太奇、静态循环、静态标题卡、素材混剪及自由构建。如需短篇无旁白、以动效为主的单元(包括动画标题),请改用 motion-graphics。在使用此技能前,应先通过 hyperframes 进行全新创作。

tia-skills 是什么?

此技能(MattiaIppoliti/tia-skills)是一个 AI 代理技能,专为使用 HyperFrames 框架(基于 Remotion + React)创建视频制作场景。它作为无法使用专门工作流时的通用处理程序,处理从品牌宣传片到素材混剪等多种场景。其关键价值在于,它优先使用标准化工作流(/hyperframes、/hyperframes-core、/media-use 等),并遵循严格的、基于检查点的创作流程,包括计划、草图、构建和最终预览。该技能设计为在“自动化”模式(独立执行)和“协作”模式(与用户共同创作)下工作,并强制要求遵循官方参考文档(如 BRIEF.md 格式和组件合同)而非凭记忆操作。目前存在一个关键限制:该技能文档描述的是已退役的 HTML+GSAP 管道,而输出框架已迁移至 Remotion + React。AI 代理必须利用其设计理念(故事结构、节奏、视觉设计),但通过 /hyperframes-core 的 Composition 和 Sequence 组件表达最终结果。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/general-video

在你喜欢的 AI 中提问

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

文档

⚠ 合约状态:尚未移植到 Remotion

此堆栈的输出框架是 Remotion + React (/hyperframes-core)。此 技能仍描述已退役的 HTML + data-* + 暂停的 GSAP 时间线 管道,其捆绑的脚本仍会以该合约发出 index.html。

在移植完成之前:

  • 不要运行 npx hyperframes <anything> —— 该 CLI 已退役。/hyperframes-cli 会将每个旧命令映射到其 Remotion 等效命令。
  • 不要将其 data-* 标记或 GSAP 时间线代码复制到 Remotion 项目中。
  • 要从中汲取其工艺:故事结构、剪辑节奏、视觉设计、 关于屏幕上显示内容的决策。这部分是框架无关的,并且是 此技能仍保留的原因。
  • 要通过 /hyperframes-core 的合约表达结果:<Composition>、 <Sequence> 以及从 useCurrentFrame() 派生的值。

在你的摘要中说明你是何时绕过此限制的,以便完成移植。

通用视频

在依赖此工作流之前,请运行:

npx hyperframes skills update general-video

成功的空操作表示技能是最新的。如果更新失败,请显示失败信息,而不是凭记忆继续。

1. 应用跨领域源适配器

  • 媒体: 对于任何音频、图像、图标、徽标、语音、调色、LUT、处理/特效、字幕或媒体操作需求,请加载 /media-use 并遵循 ../media-use/references/resolve.md(解析、采用、复用)和 ../media-use/references/setup-providers.md(提供者、认证)。模糊的素材反馈和命名样式在编辑前使用 ../media-use/references/media-treatments.md;不要即兴使用 CSS/SVG/不透明度来模拟受支持的媒体效果。在第一次经过身份验证的提供者操作之前,请运行 npx hyperframes auth status 并逐字输出其结果。如果已注销,请应用 ../hyperframes-core/references/brief-contract.md 中的门控:协作模式等待登录或明确的离线选择;自主模式说明状态并通过可用的离线提供者继续。当没有离线提供者可以满足所需功能时,显示阻塞。仅本地采用不需要认证门控。
  • Figma: 如果任何输入是 figma.com URL,请先运行 /figma。使用其导出的资源、令牌、组件或故事板帧进行构建。不要使用原始的 Figma 连接器调用,因为它们会跳过 SVG 清理、媒体溯源和品牌令牌绑定。

这些适配器不会更改 /hyperframes 选择的工作流。

2. 从项目状态开始

应用第一个匹配的行;不要评估较低的状态行:

状态操作
特定编辑进行编辑,保留现有项目决策,然后重新运行受影响的检查。不要重新开始探索。
BRIEF.md 存在读取它。如果 workflow 命名了另一个工作流且 flow 不是 companion,则移交。不要询问简报问题。
无简报,但存在 hyperframes.json 或 STORYBOARD.md从文件和记录的首选项继续。仅根据已知事实回填 BRIEF.md。
全新创作运行 /hyperframes 及其意图层。仅当 workflow: general-video 或 flow: companion 时返回此处。

对于新项目,从简报中选择一个 kebab-case 格式的目录名称,并在编写简报前进行搭建:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

然后在项目根目录使用 ../hyperframes-core/references/brief-format.md 编写 BRIEF.md。在现有项目中,根目录是包含 hyperframes.json 的目录。仅记录简报格式指定的、经过确认的偏好支持字段,使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>;绝不记录推断的默认值。这里的 <MEDIA_DIR> 是已安装的 /media-use 技能目录,<PROJECT_ROOT> 是包含 hyperframes.json 的目录。如果意图层采纳了配方,请立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 应用它,并且不要再次询问。

3. 解释运行形态

仅使用 ../hyperframes-core/references/brief-contract.md 中的规范术语:

字段含义效果
flow谁驱动automation:选择并执行路线。companion:在对话中共同创作。
storyboard画板是否是审查表面yes:运行计划与草图审查。no:无需画板直接构建。
派生 mode检查点门控如何工作遵循简报合约。绝不让用户命名模式。

不要为这些状态发明同义词。持续的“只管构建”信号由意图层处理,并以 flow: automation, storyboard: no 的形式到达。

  • 对于 flow: automation,选择路线,并在第一次进度更新中用一行说明。
  • 对于特定编辑,进行编辑,不要发明新路线。

对于现有素材的硬切、修剪、拼接或重新排序,将同一视频源复制到多个剪辑元素中。在每个副本上,使用 data-media-start 加 data-duration 设置源范围,然后使用 data-start 设置作者化的放置/顺序。单独创作的音频遵循匹配 <audio> 元素上的相同剪辑范围和时序。/hyperframes-core 拥有此时间编辑;仅当需要视觉属性动画(如缩放、推进、平移、裁剪、遮罩或内部包装器上的 clip-path)时,才使用 /hyperframes-keyframes。从 ../hyperframes-core/references/editing-recipes.md 复制完整合约。

协作流

当 flow: companion 时:

  • 读取 BRIEF.md 并将已接受的 ## Assets 和 ## Customizations 与项目制品对齐。完成仍然待处理且已接受的工作;已完成的留下不管;不要再次提供已接受的功能,仿佛它是新的。
  • 以导演而非承包商的身份介入。 选择协作的用户选择了参与和质量;诚实的回应是你能设计出的最佳版本,而不是你能辩护的最小版本。第一个计划是天花板处理:故事弧(借用最近的类型镜头——菜单 § 类型镜头)、设计规范、每个场景的动效处理(按 § 5 的计划纪律引用名称)、转场、音频身份——音乐和声音标记,或有意为之的静音——放置用户素材,以及设计好的开场和结尾。用一行说明每个层添加了什么;在命名时标记昂贵的层(渲染时间、登录、计费)。用户削减处理方案;他们永远不必通过一次一次的批准来组装一个方案。
  • 天花板属于概念,而非工具箱。 每一个层都必须服务于简报的信息——一个以同样方式装扮任何视频的处理方案只是装饰。工艺上升到天花板;内容永远不会超出所要求的范围(§ 6)。
  • 在检查点之间,../hyperframes/references/capability-menu.md 以两种方式工作。作为触发器列表:当用户提到其输入或构建达到其需求时,提供相关功能。作为每次通过的升级通道:计划、草图或构建检查点可以包含一两个指向用户正在查看的素材的追踪提供(“场景 3 的统计数据想要计数处理”)。在提供之前读取它;切勿转储完整目录。
  • 用户接受某项功能后,立即生成其制品并将决策记录在匹配的 BRIEF.md 正文部分。仅当用户明确更改时,才重写前置元数据字段并记录确认的偏好。
  • 保持相同的画板、验证、最终预览和渲染批准门控。协作改变的是谁在掌舵,而不是质量要求什么。

4. 在每个阶段前加载所需知识

当条件匹配时,这些读取是强制性的:

条件在行动前读取
任何合成 HTML 或场景布局/hyperframes-core;使用 references/determinism-rules.md 了解其布局合约
任何非平凡的创作或视觉处理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何动效、动画或场景转场/hyperframes-animation;遵循其路由到匹配的规则、适配器、蓝图或转场参考
storyboard: yes../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/review-loop.md
任何媒体资源或操作,包括旁白、背景音乐、音效、字幕、调色或变换/media-use;对于框架播放和放置,还需读取 /hyperframes-core → references/media.md
多场景组装../hyperframes-core/references/production-loop.md
flow: companion,在第一个计划之前/hyperframes-creative → references/story-spine.md 和 references/house-style.md;最近的类型镜头以及完整的 ../hyperframes/references/capability-menu.md——天花板处理是基于这些设计的,而非回忆
协作功能提供、捕获、节拍网格、生成视频、映射、发布或跨工作流功能../hyperframes/references/capability-menu.md
存在设计规范,在最终批准之前/hyperframes-creative → references/design-adherence.md

不要用回忆替代这些读取。渐进式披露仅在实际加载匹配的参考文档时才能节省上下文。

5. 执行合成

使用此依赖顺序。仅当输入缺失时跳过某个阶段。

  1. 计划。 说明观众弧、结构、节奏和时长驱动因素。对于简短的单场景使用单个文件;对于三个或更多硬场景切换或任何重复使用的场景,使用子合成。阅读 /hyperframes-creative → references/story-spine.md 了解叙述弧,references/beat-direction.md 了解节奏,以及 /hyperframes-core → references/project-structure.md 了解结构。对于开放式多场景简报,通过 /hyperframes-creative → references/prompt-expansion.md 扩展提示。多场景计划引用每个场景的形状:来自 /hyperframes-animation → blueprints-index.md 的蓝图 ID(当合适时),或者当没有合适蓝图时,引用来自 rules-index.md 的命名规则组合——动效名称来自这些索引,绝不发明。故事真相决定哪些场景存在;引用修饰它们。多场景计划也记录为调度制品:STORYBOARD.md 中每个场景一个 ## Frame N 块——status: outline、声明的 src:、蓝图/规则引用以及节拍文本——即使当 storyboard: no 时。该块是调度单元;画板仅是审查表面。
  2. 在请求时审查计划。 对于 storyboard: yes,在这些块上运行共享审查循环。对于 storyboard: no,继续而不打开画板。当计划暂停仍然发生时,

…

[为翻译而截断]

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

相关技能