Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

在HyperFrames Studio中与用户协作时使用:首先判断消息是否要求更改(问题、松散想法和“不要更改任何内容”得到回答和计划,而非编辑);对于新影片,遵循启动影片的计划、故事板和构建顺序;以及如何布局时间线使其清晰易读(一个字幕轨道,每个轨道一种元素类型,每个场景一个子合成),以及字幕和关键内容可能位于的安全区域。不要用于如何进行单个编辑(分割、修剪、调速、音量、复制、交换):这属于 `/hyperframes-core` 中的 `creator-editing-recipes.md`。

hyperframes-instruct 是什么?

该技能专为HyperFrames Studio中的AI助手设计,用于指导如何与用户协作处理影片项目。其核心是在进行任何编辑之前,首先通过对话分析用户意图:如果用户明确要求更改,则直接执行;如果只是提问或提供感觉性的反馈,则先回答或分析后再更改;如果用户明确表示不更改,则不做任何修改。对于新影片项目,它遵循一套标准化的构建流程:计划、故事板、构建,并引用了多个相关参考文件。此外,该技能定义了HyperFrames Studio的时间线组织约定,包括每个场景必须作为子合成、所有字幕位于单一轨道、每个轨道只包含一种元素类型,以及动作安全和字幕安全区域。重要的是,它不涉及具体的编辑操作(如分割、修剪等),这些由另一个技能 `creator-editing-recipes.md` 处理。它支持HyperFrames Studio平台,适用于从零开始构建影片、修改现有项目或提供创意指导的场景。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/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 提供方向;对于本影片的一个想法,针对所指部分提供两到三个选项。推荐一个。
  • 以下一步和启动它的词结束("说构建,我就开始")。

将计划保存在项目中,而不仅仅在聊天中:下一条消息可能开始一个看不见这次聊天的全新会话。按照 /hyperframes-creative 的 references/storyboard-recipe.md 第 4 节记录一轮反馈的方式,将其添加到 STORYBOARD.md 中;切勿覆盖已锁定的帧。如果用户要求完全不做任何更改,则什么也不写:将计划放在回复中并提出保存。

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

根合成仅包含定时的主机、媒体和音频。任何具有嵌套结构的场景(包含子元素的 div、带字幕的标题、图表)都使用 data-composition-src 加载为其自身文件,详见 /hyperframes-core 的 references/sub-compositions.md。

留在根元素内的嵌套标记不会变成自己的行。它会隐藏在一个无法逐部分修剪或移动的不透明行中。

请像有一个结构检查器会拒绝任何违规一样进行创作。

2. 单一字幕轨道

  • 所有字幕都位于一个轨道上:一个单一的子合成主机(一个 data-track-index)标记为 data-track-kind="captions",并按顺序承载每个字幕组。
  • 永远不要每个字幕组占用一行,也不要将字幕与其他类型的元素混合在一个轨道上。
  • 字词定时规则不变:请参阅 /embedded-captions 和 caption_* lint 规则。

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

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.

相关技能