Communitygithub.com

1345AbhishekKumar/starter-nextjs

HyperFrames视频的非动画创意指导。用于处理设计规范(frame.md / design.md)、调色板、排版、旁白、节拍规划、音视频响应、构图模式以及品牌/风格决策。对于原子级运动模式和场景蓝图,请使用`hyperframes-animation`。

starter-nextjs 是什么?

该技能专为 HyperFrames 视频的创意方向设计,但明确排除动画实现。它专注于品牌、节奏、风格、旁白和构图的决策,在 `hyperframes-core` 的技术合同建立后使用。其核心是处理设计规范(如 frame.md/design.md),并基于前端元数据驱动调色板、字体和约束。技能通过程序化工作流引导用户:首先强制阅读 `references/house-style.md` 和 `references/video-composition.md` 以避免生成网页风格的输出,然后根据是否有设计规范选择路线(预设帧、命名风格或快速默认值)。为支持多场景作品,它提供节拍规划、过渡定时、音视频响应映射和构图模式(如画中画、标题卡、数据图表)的参考文档。此外,该技能包含用于对比检查、音频数据提取和打包工具的脚本。它明确声明不覆盖 `hyperframes-core` 的规则,也不为最小技术构成强加设计系统。对于运动模式和场景蓝图,应使用 `hyperframes-animation`。

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

在你喜欢的 AI 中提问

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

文档

HyperFrames 创意指导

品牌、节奏、风格、旁白和构图方向。在 hyperframes-core 的技术合同建立后使用。

对于运动模式、场景蓝图、转场和 CSS 标记效果,请使用 hyperframes-animation —— 该技能明确不涉及动画。

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

  • references/house-style.md —— “解释提示、生成真实内容”、惰性默认列表以及背景/前景图层配方。这是将字面样式转换变为 概念 的关键。
  • references/video-composition.md —— 视频媒介密度、缩放、前景元数据(“制作而非生成”的细节:数据条、注册标记、等宽字体读数、每场景 8-10 个元素)。

跳过这两份文件是产生通用网页风格输出的最大原因。在下方的路由表中,它们不是可选项 —— 对于任何超出单行编辑的任务,在选择颜色或编写 HTML 之前,请先打开这两个文件。

工作流程

  1. 如果项目有设计规范,先阅读它,并将其前端元数据令牌视为品牌真理(颜色、字体、间距、语气、约束)。应读取哪个文件(优先级 frame.md → design.md → DESIGN.md)以及如何解析(前端元数据 = 规范性,正文 = 上下文)在 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/narration.md
预计算的音频频段映射到运动references/audio-reactive.md

脚本

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

从仓库根目录使用显式路径运行,例如:

python skills/hyperframes-creative/scripts/extract-audio-data.py <音频文件>

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

边界

  • 不要覆盖 hyperframes-core 的技术规则。
  • 不要为最小的技术构成强加设计系统。
  • 除非请求要求或你首先提出扩展,否则不要添加额外的场景、旁白、音乐、字幕或转场。
  • 保持配方引用针对具体任务;对于简单编辑,不要读取每个参考资料。

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-nextjs

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-nextjs

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-nextjs

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-nextjs

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-nextjs

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-nextjs

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-nextjs

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

相关技能