Communitygithub.com

Elis3omndz/Claude_Skills

用于在Studio中处理HyperFrames项目时与用户协作:判断消息是否请求更改,规划新影片,以及按照约定构建时间线。

Claude_Skills 是什么?

此技能专为在 HyperFrames Studio 中工作的 AI 代理设计,提供一套完整的约定和流程,帮助代理与人类用户高效协作。其核心功能在于指导代理如何理解用户意图:区分指令、问题、反馈和新想法,并采取相应的行动(如直接修改、回答、规划或仅对话),从而避免不必要的修改。技能详细规定了时间线的构建标准,包括使用子合成来表示每个场景、为所有字幕使用单一轨道、每种元素类型独占一个轨道,并定义了安全区域(action-safe 和 title-safe 框)以保证内容在画面中的正确位置。对于新影片,技能描述了从简报、方向、故事板到构建和审阅的完整工作流程,并特别针对产品发布提出了额外要求,如使用真实产品素材、保持世界一致性等。该技能主要应用于 HyperFrames Studio 环境,并依赖 `/hyperframes-core` 和 `/hyperframes-creative` 等仓库中的具体参考文档来执行详细操作。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/hyperframes-studio

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行设置或新鲜度命令之前,如果此技能位于 HyperFrames 插件内,请遵循插件执行规则。独立安装时,请保留下面的更新说明。

HyperFrames Studio 约定

Studio 为每个顶层元素绘制一个时间线行。遵循以下规则的项目将打开为简短、可读的时间线;不遵循的项目将打开为一堆无法编辑的未标记行。以下是构建时需要遵循的约定。有关如何修改片段,请遵循 /hyperframes-core references/creator-editing-recipes.md,并且绝不发明同一编辑的不同形式。

0. 先沟通再构建

在打开文件之前请先阅读消息。判断它要求什么:

用户你
提出更改,无论如何礼貌(“把标题放大点”,“能剪掉第三场吗?”)执行修改。
对已构建的影片提供感性反馈(“开头感觉不连贯”,“时长不够”)找出原因,更改可测量的内容,说出反馈的含义以及修改了什么,并根据 /hyperframes-creative references/storyboard-recipe.md § 4 进行记录。
提问且未提及更改(“为什么标题会跳动?”)回答问题。不修改任何内容。
说不要更改,暂停,“只是想想”,“我们谈谈”不修改任何文件,即使是你注意到的修复。用语言提供建议。
为这部影片提出一个想法但没有具体的更改(“我想要结局更有感染力”)提出更改并将其添加到计划中(见下文)。不修改任何合成文件。
请求一部新影片规划它(§ 5)。
批准计划(“构建它”,“开始”)构建已批准的内容。

一条既提问又提出更改的消息,应同时给出答案和更改。只有当你无法判断它是否要求任何内容时,它才是一场对话:错误的答案只浪费一条消息;错误的构建则浪费一次长时间的运行和一轮反馈。

一次对话回复:

  • 首先用几句话简明扼要地回答。
  • 只问那些答案会影响影片的问题,每个问题都附带一个推荐答案及其权衡(“30 秒适合信息流;60 秒为演示留出空间”)。
  • 当有一个想法需要成形时:对于新影片,根据 /hyperframes references/pitch-round.md 提供方向;对于关于本片的想法,提供两到三个针对所提部分的选项。推荐其中一个。
  • 以下一步操作和开始执行的词语结束(“说构建然后我就开始”)。

将计划保留在项目中,而不仅仅在聊天记录里:下一条消息可能开启一个无法看到本次聊天内容的新会话。将它添加到 STORYBOARD.md 中,方式如同 /hyperframes-creative references/storyboard-recipe.md § 4 记录一轮反馈那样;切勿覆盖已锁定的帧。如果用户要求你完全不做任何更改,则什么也不写:将计划放在回复中并提供保存。

1. 每个场景都是一个子合成

根合成仅包含计时宿主、媒体和音频。任何具有嵌套结构(包含子元素的 div、带副标题的标题、图表)的场景都是独立的文件,通过 data-composition-src 加载,接线方式参见 /hyperframes-core references/sub-compositions.md。

留在根合成内部的嵌套标记不会成为单独的行。它会藏在一个不透明的行中,该行无法被部分地修剪或移动。

编写时,将其视为存在一个结构检查器会拒绝任何违规行为。

2. 一个字幕轨道

  • 所有字幕都位于一个轨道上:一个单一的子合成宿主(一个 data-track-index)标记为 data-track-kind="captions",按顺序承载每个字幕组。
  • 绝不能每个字幕组一行,也绝不能将字幕与另一种类的元素混合到同一轨道上。
  • 逐字时间规则不变:请参阅 /embedded-captions 和 caption_* 检查规则。

3. 每个轨道一种元素种类

按种类分组,使得每一行都是一个用户可以作为一个整体选择、静音或拖动的单一事物。

种类data-track-kind
基础视频 / A-rollvideo(来自标签)
场景、叠加层、图形graphics
字幕captions
音频(画外音、音乐、音效)audio(来自标签)

将 data-track-kind 放在子合成宿主上。视频和音频种类来自标签,因此 <video> 和 <audio> 不需要属性。为每个种类分配自己的 data-track-index;该数字仅用于显示,不会改变哪个元素渲染在顶层。使用 CSS 进行分层。

4. 安全区域

任何标尺或安全框叠加层都位于预览窗格中,绝不在合成内部,因此不要向 HTML 添加引导元素。 两种画幅(宽屏和竖屏)都使用相同的两个安全框,即 Premiere 的默认设置。预览切换会在每条边的中点绘制一个刻度标记。来源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。

框占画面比例每条边内缩进
动作安全框90%5%
标题安全框80%10%
  • 安全边距:所有可见元素都保持在动作安全框(90%)内,并且字幕和关键内容都保持在标题安全框(80%)内。
  • 双画面和 50/50 布局应保持每半部分的内容位于标题安全框内。

5. 新影片:规划、故事板、构建

hyperframes-launches 影片是按此顺序制作的。每个步骤都有负责人;请遵循它,不要在此处重述。

步骤负责人
1. 简报/hyperframes references/intent-interview.md。在现有项目中,仅保留对同一影片的后续处理:新版本或缩减版,相同的工作流程和宽高比。询问其必须回答的问题,跳过 hyperframes init,切勿覆盖 BRIEF.md 或 STORYBOARD.md,为每个文件添加新的带日期的部分,并在回复中说明。不同工作流程或宽高比的影片将启动一个新项目,回复中也会说明。
2. 方向/hyperframes references/pitch-round.md
3. 故事板/hyperframes-creative references/storyboard-recipe.md
4. 构建简报所路由到的工作流程(/hyperframes § 2)及其自身的参考
5. 反馈/hyperframes references/review-loop.md

以下是发布影片为产品发布添加的内容。如果工作流程的选定故事弧另有规定,则以故事弧为准。

  • 已发布产品的真实素材。 在简报中索要屏幕录制,除非工作流程自身能捕获(如通过 URL 捕获网站),并用带标签的占位符保留其位置,直到素材到达。切勿近似模拟已发布产品的用户界面。作为上下文显示的第三方工具(聊天应用、编辑器)应基于截图精确重建。
  • 同一世界。 相同的窗口或画布在各个节拍间持续存在。检查每一个剪辑点:任何持续存在的元素不得出现跳跃。
  • 光标和滚动内容。 光标或窗口自身滚动出去的内容,应从窗口或框架边缘离开,而不是通过在画面中淡出。元素和文本的切换遵循工作流程的 cut-catalog.md(如果有)。
  • 以命令或地址特写结束, 徽标落在仍在运动的素材中。
  • 在每个版本中注明运行时。 超出目标时长由用户决定,而非你。

检查您的工作

运行 hyperframes check(它会运行 lint)并修复每个发现的问题。然后打开 Studio 中的项目,检查时间线是否显示一个基础行、每个场景宿主一行、一个字幕行以及音频行。

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_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.

Elis3omndz/Claude_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), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). 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`.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

相关技能