Communitygithub.com

sansayan01/general-video

사용자 정의 HyperFrames 구성을 작성하거나 편집하는 폴백 워크플로우입니다. 긴/멀티씬 작품, 브랜드 및 시즐 릴, 몽타주, 타이틀 카드, 정적 루프, 자유 형식 빌드 등 모든 길이와 형식을 지원합니다. 입력이 전문 워크플로우에 맞지 않을 때만 사용하며, 라우팅 테이블은 /hyperframes에 있습니다.

general-video란 무엇인가요?

이 스킬은 HyperFrames를 사용하여 사용자 정의 비디오 구성을 제작하기 위한 포괄적인 폴백 워크플로우입니다. 제품 출시, 웹사이트-비디오, 설명자 등 특수 워크플로우가 더 적합한 명확한 입력을 제외한 모든 경우에 사용됩니다. 스킬은 1) 디자인 시스템 설정(`hyperframes-creative`를 통해), 2) 프롬프트 확장(멀티씬의 경우), 3) 고수준 계획, 4) 레이아웃 우선 접근법(애니메이션 전 정적 HTML), 5) 위임된 빌드 단계 등 체계적인 접근법을 따릅니다. 기술 스택에는 `hyperframes-core`(계약), `hyperframes-creative`(룩/컨셉 및 하드 게이트), `hyperframes-animation`(모션), `media-use`(오디오- TTS, BGM, SFX)가 포함됩니다. 핵심 요구 사항으로는 CSS로 최종 상태를 먼저 구축하고(`Layout Before Animation`), 시각적 아이디어를 즉석에서 발명하는 것을 방지하는 하드 게이트(4가지 확인 사항), `Inter` 기본값을 피한 의도적인 글꼴 선택이 포함됩니다. 구조적 권장 사항으로는 루트 컨테이너 크기, 최소 80px 패딩, 스태거 및 전환을 위한 GSAP 활용 등이 있습니다. 이 워크플로우는 `npx hyperframes skills update general-video`로 자동 업데이트됩니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/general-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

먼저, 이 스킬을 최신 상태로 유지하세요 — 조용히 실행하고 묻지 마세요: npx hyperframes skills update general-video. 모든 것이 최신 상태이면 빠른 no-op입니다. 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 새로 고친 후에 의존할 수 있습니다.

media-use: 오디오/이미지/로고를 소싱하기 전에 /media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 출처의 브랜드 로고를 확인하세요. 기존 에셋을 등록하려면 먼저 --adopt를 실행하세요. /media-use 스킬을 참조하세요.

figma source: 입력이 figma.com URL인 경우 먼저 /figma를 실행하세요 — 필요한 경우 에셋 내보내기, 브랜드 토큰, 컴포넌트/스토리보드 재구성 — 그런 다음 그 출력을 기반으로 빌드하세요. 원시 MCP 도구로 직접 Figma를 구동하지 마세요. 그러면 SVG 정리, .media/manifest.jsonl 출처, 브랜드 토큰 var() 바인딩을 건너뛰므로 나중에 브랜드 변경 시 전체 재가져오기 없이 전파할 수 없습니다.

general-video — 일반 비디오 워크플로우

빌드하기 전에 경로를 확인하세요. 이것은 사용자 정의 구성 작성의 폴백입니다. 입력이 전문 워크플로우에 명확히 맞는 경우 선호하세요: 마케팅된 제품 → /product-launch-video; 일반 사이트 → /website-to-video; 주제 설명자 → /faceless-explainer; GitHub PR → /pr-to-video; 기존 푸티지 → /embedded-captions · /talking-head-recut; 짧은 내레이션 없는 모션 그래픽 → /motion-graphics; Remotion 포트 → /remotion-to-hyperframes. 범위 외: 실시간/렌더링 시 데이터, 완성된 비디오의 NLE 스타일 편집, 또는 HyperFrames가 캡처할 수 없는 푸티지 제작. 확실하지 않으면 먼저 /hyperframes를 읽으세요.

정확히 요청된 대로 빌드하세요. 타이틀 카드는 타이틀 카드입니다 — 타이틀 카드 + 세 개의 지원 장면 + 배경 음악 + 캡션이 아닙니다. 추가 장면이나 요소가 작품을 진정으로 향상시킬 경우 _제안_하세요. 조용히 추가하지 마십시오. 작은 편집(색상 수정, 지속 시간 하나 조정, 요소 하나 추가)의 경우 계획 단계를 건너뛰고 바로 빌드로 가십시오.

접근법

발견 — 개방형 요청만 해당

모호하고 탐색적인 요청("우리 브랜드를 위한 무언가를 만들어 줘", "멋진 인트로")의 경우 — 색상을 고르기 전에 의도를 이해하세요:

  • 대상 — 누가 시청합니까? 개발자 / 임원 / 일반 소비자?
  • 플랫폼 — 어디에서 재생됩니까? 소셜(15초) / 웹사이트 히어로 / 제품 데모 / 내부용?
  • 우선 순위 — 가장 중요한 것은? 모션 품질 / 내용 정확성 / 브랜드 충실도 / 속도?
  • 변형 — 하나의 최선 샷, 또는 의미 있게 다른 2-3개 옵션(색상 교체만이 아닌 다른 페이싱, 에너지 또는 구조)?

특정 요청("타이틀 카드 추가", "씬 3의 타이밍 수정")의 경우 발견을 건너뛰세요. 요청에 지속적인 자율 신호가 포함된 경우("놀래켜 줘", "그냥 만들어 줘" — hyperframes-core/references/brief-contract.md § 1), 발견도 건너뛰세요: 하나의 최선 샷으로 기본 설정하고 결정을 내릴 때 한 줄 영수증으로 알리세요.

1단계 — 디자인 시스템 → hyperframes-creative

먼저 시각적 아이디어를 확립하세요. 프로젝트에 디자인 스펙이 있으면 읽으세요(우선 순위 frame.md → design.md → DESIGN.md; 이를 브랜드 진실로 취급 — 정확한 색상, 글꼴, 제약 조건).

스펙이 없으면 색상이나 글꼴을 선택하기 전에 hyperframes-creative/references/house-style.md와 hyperframes-creative/references/video-composition.md를 모두 읽어야 합니다. house-style.md는 "프롬프트 해석 / 실제 콘텐츠 생성" 오프너, 느린 기본값 목록 및 레이어 레시피를 제공합니다. video-composition.md는 "제작된" 것과 "생성된" 것을 구분하는 비디오 매체 밀도/스케일/ 전경 세부 정보(데이터 막대, 등록 표시, 고정폭 메타데이터, "8-10개 요소, 그 중 두 개는 사용자가 요청하지 않은 것")를 제공합니다. 하나만 읽는 것이 가장 흔한 실수입니다 — video-composition.md는 에이전트가 건너뛰는 바로 그것이며, 평평하고 중앙에 맞춰진 웹 페이지처럼 보이는 출력을 방지하는 바로 그것입니다. 팔레트를 스스로 발명하고 이를 건너뛰지 마십시오. hyperframes-creative로 들어가는 것은 선택적 분기가 아니라 필수입니다. 거기에서 명명된 스타일/분위기 → references/visual-styles.md 또는 대화형 선택기 → references/design-picker.md도 필요에 따라 가져오세요. 스펙/스타일은 브랜드를 정의하며 구성 규칙이 아닙니다.

앵글 찾기(모호한 브리프, 스펙 없음): 색상을 고르기 전에 한 문장을 작성하세요 — 이 이름/단어/주제는 무엇을 불러일으키며, 어떤 시각적 세계(은유, 설정, 악기, 모티프)가 이를 표현합니까? 예: 사이버 보안 도구 → 금고 문 / 경계 스캔 라인 / 자물쇠 텀블러; 명상 앱 → 밀물, 숨결, 느린 빛의 발산. 주제의 _의미_를 읽으세요. 글자만 읽지 마십시오. 문자 그대로의 재스타일링보다 구체적인 앵글을 선택하세요. 이것은 단일 장면 작품(확장이 올바르게 건너뛰어짐)에서 프롬프트 확장(2단계)의 저렴한 대체품이며 — 설계된 개념과 그라데이션 위의 일반 로고의 차이입니다.

<하드-게이트> HTML 구성을 작성하기 전에, 네 가지를 모두 가지고 있는지 확인하세요:

  1. 시각적 아이디어 — 스펙 또는 house-style.md에 근거하며 즉석에서 발명되지 않았습니다. (#333, #3b82f6 또는 Roboto에 도달하고 있습니까? 건너뛰었습니다.)
  2. 한 문장 개념 앵글 ("앵글 찾기" 단계) — 사소한 편집 이상의 모든 것에 대해, 프롬프트 단어의 문자 그대로의 재스타일링이 아닙니다.
  3. 임베드 목록의 글꼴 쌍 (hyperframes-creative/references/typography.md → "임베드되는 글꼴") — 의도적으로 선택되었으며 Inter/Helvetica Neue/system-ui가 기본값이 아니며, 렌더링되길 바라며 임베드되지 않은 디스플레이 글꼴은 절대 사용하지 않습니다(번들되지 않은 이름은 로컬에서 자동 캡처된 경우에만 임베드됩니다 — 클라우드 렌더링은 이를 캡처하지 않습니다).
  4. video-composition.md의 전경/밀도 계획 — 가장자리 앵커링, 8-10개 요소, 전경 메타데이터, 배경 텍스처 규칙. (~6개 미만 요소, 가장자리 앵커링 세부 정보 없이 평평한 색상 위 중앙 스택? 건너뛰었습니다 — 그것이 일반적인 신호입니다.) </하드-게이트>

2단계 — 프롬프트 확장 → hyperframes-creative

모든 멀티씬 구성에 대해 실행하세요(단일 장면 작품 및 사소한 편집은 건너뜀). 요청을 디자인 스펙 + 하우스 스타일에 대해 일관된 중간 표현으로 접지하여 다운스트림 작업이 동일하게 읽도록 합니다. hyperframes-creative/references/prompt-expansion.md를 참조하세요.

3단계 — 계획

HTML을 작성하기 전에 높은 수준에서 생각하세요:

  1. 무엇 — 시청자 경험: 내러티브 아크, 주요 순간, 감정적 비트. 내레이션 스토리 작품의 경우 hyperframes-creative/references/story-spine.md를 따르세요 — 시청자 결과 언어로 훅, 비트 2까지 메시지 도착, 그 후 증거.
  2. 구조 — 구성 수, 하위 구성 대 인라인, 비디오/오디오/오버레이/캡션을 전달하는 트랙. 단일 파일 대 모듈식 하위 구성 결정은 hyperframes-core/references/composition-patterns.md § 두 아키텍처 참조(경험 법칙: ≥3 하드 씬 컷, 또는 재사용된 씬 → 모듈화; 짧은 단일 장면 작품은 하나의 파일로 유지).
  3. 리듬 — 구현하기 전에 패턴 이름 지정(예: 빠름-빠름-느림-셰이더-홀드); hyperframes-creative/references/beat-direction.md 참조.
  4. 타이밍 — 클립이 지속 시간을 결정하는 위치, 전환이 발생하는 위치, 페이싱.
  5. 레이아웃 — 먼저 최종 상태 구축(아래 참조).
  6. 애니메이트 — 그런 다음 hyperframes-animation을 통해 모션 추가.

애니메이션 전 레이아웃

모든 요소를 가장 시각적으로 두드러지는 순간에 배치하세요 — 완전히 진입하고, 올바르게 배치되며, 아직 종료되지 않음. 이를 먼저 정적 HTML + CSS로 작성하세요. 아직 GSAP는 사용하지 마세요.

이유: 요소를 애니메이션된 시작 상태(화면 밖, 0으로 축소, 불투명도 0)에 배치하고 도착한다고 생각하는 위치로 트윈하면 최종 레이아웃을 추측하는 것입니다 — 겹침이 렌더링될 때까지 보이지 않습니다. 먼저 최종 상태를 구축하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.

  1. 각 씬의 히어로 프레임 식별 — 가장 많은 요소가 동시에 보이는 순간. 그것이 당신이 구축할 레이아웃입니다.
  2. 해당 프레임에 대한 정적 CSS 작성. 콘텐츠 컨테이너는 절대 오프셋이 아닌 패딩으로 씬을 채워야 합니다:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* 패딩이 콘텐츠를 배치합니다. 모든 씬 크기를 채웁니다 */
  gap: 24px;
  box-sizing: border-box;
}

콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마십시오 — 콘텐츠가 공간보다 더 높을 때 넘칩니다. 장식 요소에 대해 절대 위치 지정을 예약하세요.

⚠ 위의 width/height: 100%는 모든 상위 요소가 해결된 높이를 가질 때만 해결됩니다. 루트 <div data-composition-id>와 그와 .scene-content 사이의 모든 래퍼는 크기가 지정되어야 합니다(루트에 position: relative; width: 1920px; height: 1080px — hyperframes-core → "루트는 크기가 지정되어야 함" 참조). 이렇게 하지 않으면 flex 컨테이너가 ~0으로 축소되고, 콘텐츠가 왼쪽 상단 모서리로 쌓이며, 첫 글리프가 x=0에서 잘립니다 — lint/inspect가 여전히 0 문제를 보고하는 동안에도 마찬가지입니다. 그리고 항상 .scene-content에 padding(≥80px)을 유지하십시오: 이것은 타이틀-세이프 여백입니다. 그것을 단순한 gap으로 절대 대체하지 마십시오.

  1. 진입 추가 — 화면 밖/보이지 않음에서 CSS 위치로 gsap.from()을 사용하여 애니메이트(하위 구성에서는 시작 상태가 명시적이도록 gsap.fromTo() 선호; hyperframes-core/references/sub-compositions.md 참조). CSS 위치가 ground truth입니다. 트윈은 그 위치로의 여정입니다.
  2. 종료는 전환으로 처리 — hyperframes-animation/transitions/의 씬 전환 규칙에 따라 최종 씬만 요소를 종료 애니메이트합니다. 씬 사이에서 전환 자체가 종료입니다.

시간에 따른 공유 공간: 요소 A가 같은 영역에서 요소 B가 진입하기 전에 종료하는 경우, 둘 다 각자의 히어로 프레임에 대해 올바른 CSS 위치가 필요합니다 — 타임라인 순서가 공존을 방지하고, 레이아웃 단계에서 우발적인 겹침을 잡습니다. 레이어된 광택/그림자 및 z-스택 깊이는 의도적인 겹침입니다. 이 단계는 의도하지 않은 충돌(두 개의 헤드라인이 서로 위에, 콘텐츠가 프레임 밖으로 번짐)을 잡는 것입니다.

빌드 — 도메인 스킬에 위임

이것은 스킬의 전체 표면(설명 참조)을 해당 참조에 매핑합니다 — 완전하지 않습니다. 의도가 나열되지 않은 경우 hyperframes-creative(룩/컨셉), hyperframes-animation(모션), hyperframes-core(계약), media-use(오디오/캡션)를 통해 라우팅하세요. 첫 번째 행은 ADDITIVE입니다 — 의도 행과 함께 읽으세요. 하나만이 아닙니다.

빌드 대상…먼저 읽을 것 (순서대로)
항상 — 모든 중요 작품, 아래 의도 행에 추가로hyperframes-creative/references/house-style.md + references/video-composition.md (또한 1단계 / 하드-게이트에서 게이트됨; "제작되고 생성되지 않은" 전경 세부 정보)
운동 타이포그래피 / 텍스트 중심hyperframes-animation/techniques.md (운동 타입) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
타이틀 카드 / 하단 1/3 / 오버레이 / PiP / 텍스트-뒤-피사체hyperframes-creative/references/composition-patterns.md + (중앙/크기 조정 프레임의 경우) hyperframes-core → "루트는 크기가 지정되어야 함"
로고 / 브랜드 마크 리빌hyperframes-animation/rules/svg-path-draw.md (그리기 켜짐) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
데이터 / 통계 / 숫자hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
제품 / 앱 / UI 데모hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
오디오 반응형 / 음악 주도hyperframes-creative/references/audio-reactive.md (사전 추출 밴드; 모션에 매핑)
내레이션 / 음성 해설 / 음악 / SFX / 캡션media-use → 공유 오디오 엔진 scripts/audio.mjs (한 번 호출 = TTS + BGM + SFX → audio_meta.json); 캡션 작성 + 에셋 배치는 hyperframes-core를 통해. 아래 오디오를 참조하세요.
멀티씬 / 전환hyperframes-animation/transitions/overview.md 그 다음 transitions/catalog.md (개요를 읽는 것으로 끝나지 않음 — GSAP 레시피는 카탈로그에 있습니다)
모듈식 / 하위 구성hyperframes-core/references/composition-patterns.md + references/sub-compositions.md

오디오: 하나의 엔진 (TTS · BGM · SFX)

작품이 요구할 때만 사용하세요("정확히 요청된 대로 빌드"에 따라 — 타이틀 카드에 배경 음악 없음). TTS를 직접 만들거나 복사본을 공급하지 마십시오: 중립적인 audio_request.json을 작성하고 media-use의 공유 엔진을 호출하세요. 하나의 스위치에서 자동으로 저하됩니다 — HeyGen 자격 증명 있음 → HeyGen TTS + 음악/SFX 검색; 없음 → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM 생성 및 번들 SFX 라이브러리. 전체 플래그 목록 + 요청/메타 스키마는 media-use를 참조하세요.

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 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. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

sansayan01/finance_app_zo

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

sansayan01/finance_app_zo

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, 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.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

관련 스킬