Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

为 HyperFrames 视频提供非动画类的创意指导,涵盖设计规范处理、调色板、排版、旁白、节拍规划、音频响应视觉、构图模式及品牌/风格决策。原子运动模式和场景蓝图请使用 hyperframes-animation。

hyperframes-instruct 是什么?

这是一个专为 HyperFrames 视频创作设计的 AI 智能体技能,专注于非动画层面的创意方向。它帮助开发者或创作者在设计规范(frame.md / design.md)处理、调色板选择、排版、旁白、节拍规划、音频响应视觉、构图模式以及品牌/风格决策等环节进行指导。该技能适用于 Claude Code、Coder 等支持技能文件的 AI 编程助手,通过读取一系列参考文档(如 house-style.md、video-composition.md、visual-styles.md)和预设帧,确保输出内容符合 HyperFrames 的视频视觉规范,避免产生“网页风格”的平庸输出。它与 hyperframes-animation 技能互补,后者负责原子运动模式、场景蓝图和过渡动画。使用时需先阅读核心参考文档,并遵循特定的工作流:先检查设计规范,若无则选择预设帧或样式。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes-creative

在你喜欢的 AI 中提问

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

文档

插件安装: 在执行 setup 或 freshness 命令之前,当此技能位于 HyperFrames 插件内部时,请遵循 插件执行规则。独立安装则保留下面的更新说明。

HyperFrames Creative

品牌、节奏、风格、旁白和构图方向。在 hyperframes-core 提供的技术合同就位之后使用。

如需运动模式、场景蓝图、过渡和 CSS 标记效果,请使用 hyperframes-animation —— 本技能有意排除动画内容。

对于任何非平凡的构图,请先阅读以下两个文件 —— 它们会覆盖网页本能:

  • references/house-style.md —— “解释提示,生成真实内容”、惰性默认列表以及背景/前景层配方。它能将字面上重新样式化转变为真正的 概念。
  • references/video-composition.md —— 视频媒介的比例、深度和前景细节。它解释了如何避免空洞的网页布局,而不强制设定通用的元素数量。

跳过这两个文件是导致输出平庸、形似网页的最主要原因。它们不是下面路由表中的可选行 —— 对于任何超出单行编辑的任务,在选择颜色或编写 HTML 之前,请同时打开这两个文件。

工作流

  1. 如果项目有设计规范,首先阅读它,并将其 frontmatter 令牌视为品牌真理(颜色、字体、间距、语调、约束)。要读取哪个文件(优先级 frame.md → design.md → DESIGN.md)以及如何解析它(frontmatter = 规范性,prose = 上下文)已在 references/design-spec.md 中定义 —— 根据该文档解析并加载。
  2. 如果不存在设计规范且用户请求视觉方向,选择一条路径:
    • 现成帧预设(可选)→ frame-presets/(采用 FRAME.md 作为 frame.md;参见 references/design-spec.md)
    • 命名样式或情绪 → references/visual-styles.md
    • 快速默认 → references/house-style.md
    • 交互式选择 → references/design-picker.md
  3. 对于多场景工作,在编写 HTML 之前规划节拍和节奏 → references/beat-direction.md。对于场景过渡,跳到 hyperframes-animation/transitions/。
  4. 对于运动密集型工作,阅读 references/motion-principles.md(高层次护栏),然后转到 hyperframes-animation 获取原子规则。

路由

主题阅读
采用现成帧预设作为 frame.md(可选)frame-presets/ · references/design-spec.md
默认调色板、运动、排版、询问的惰性默认值references/house-style.md
命名样式预设、情绪到样式路由references/visual-styles.md
特定调色板的颜色令牌palettes/*.md
构图模式 —— 画中画、文字置于主体之后、标题卡、幻灯片references/composition-patterns.md
统计/信息图展示references/data-in-motion.md
开放式提示的结构化扩展references/prompt-expansion.md
视频媒介密度、比例、颜色、帧构图references/video-composition.md
逐节拍方向、节奏规划、过渡时机references/beat-direction.md
创作后的规范验证(颜色、字体、圆角、间距、深度)references/design-adherence.md
高层次运动护栏和 GSAP 质量规则references/motion-principles.md
字体选择、配对、渲染视频的排版护栏references/typography.md
故事原则 —— 钩子语言、证据前先提供价值、故事板作为提案、来源可追溯的视觉效果references/story-spine.md
脚本节奏、语调、开场、数字发音references/narration.md
预先计算的音频频段映射到运动references/audio-reactive.md

脚本

  • scripts/contrast-report.mjs —— 检查渲染帧中的对比度警告。
  • scripts/extract-audio-data.py —— 预先提取音频频段,用于音频响应式构图。
  • scripts/package-loader.mjs —— 创意工具捆绑包的加载支持脚本。

contrast-report.mjs 首先从当前项目解析辅助包,然后可以引导 HyperFrames 包的捆绑版本。仅当在捆绑的 CLI/技能安装之外运行技能且需要明确指定该引导版本时,才设置 HYPERFRAMES_SKILL_PKG_VERSION=<version>。

使用显式路径运行,例如:

python <SKILL_DIR>/scripts/extract-audio-data.py <audio-file>

动画分析(animation-map.mjs)位于 hyperframes-animation/scripts/。

边界

  • 不要覆盖 hyperframes-core 的技术规则。
  • 对于最小的技术构图,不要要求设计系统。
  • 除非请求要求扩展,或者您首先提议扩展,否则不要添加额外场景、旁白、音乐、字幕或过渡。
  • 保持配方引用仅限于任务特定;对于简单编辑,不要阅读所有参考。

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

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

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

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.

相关技能