Communitygithub.com

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

모든 길이와 형식의 커스텀 HyperFrames 비디오 작성을 위한 폴백 워크플로우 — 긴 영상, 멀티 씬 작품, 브랜드/시즐 릴, 몽타주, 타이틀 카드, 정적 루프, 자유형 구성 등. 입력 및 길이에 구애받지 않습니다. 입력이 명확하게 전문화된 워크플로우(마케팅 제품, 웹사이트, 주제 설명, GitHub PR, 기존 영상, 짧은 모션 그래픽, Remotion 포트)에 해당하면 해당 워크플로우를 우선 사용하고, 이 워크플로우는 적합한 것이 없을 때 일반 폴백으로만 사용하세요.

S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-란 무엇인가요?

이 스킬은 HyperFrames 기반 비디오 작성을 위한 포괄적인 폴백 워크플로우를 제공합니다. 모든 길이와 형식의 비디오를 지원하며, 텍스트 중심의 타이틀 카드부터 복잡한 멀티 씬 구성을 아우릅니다. 입력이 특화된 워크플로우(예: 제품 런칭, 웹사이트 투 비디오, 페이스리스 익스플레이너)에 명확히 해당하면 이를 우선 사용하고, 이 스킬은 적합한 전문화 워크플로우가 없을 때 일반적인 폴백으로 사용됩니다. 이 워크플로우는 디자인 시스템 구축, 프롬프트 확장, 계획 수립, '애니메이션보다 레이아웃 우선' 접근법을 통한 구현 등 일련의 단계를 따릅니다. 특히 'video-composition.md' 참조를 사용하여 단순한 '생성된' 느낌이 아닌 '제작된' 듯한 고품질 전경 디테일을 구현하도록 강제하며, 각 씬의 피크 순간에 올바른 CSS 레이아웃을 먼저 구축한 후 GSAP 애니메이션을 추가합니다. 또한 오디오(TTS, BGM, SFX) 생성을 위해 통합 엔진을 사용하며, 멀티 씬 전환, 키네틱 타이포그래피, 데이터 시각화 등 다양한 시나리오에 대한 참조 가이드를 제공합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/general-video

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

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

문서

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

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의 타이밍 수정”)의 경우 발견 단계를 건너뛰세요.

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. 무엇 — 시청자 경험: 내러티브 아크, 주요 순간, 감정적 비트.
  2. 구조 — 얼마나 많은 구성, 서브 컴포지션 vs 인라인, 어떤 트랙이 비디오/오디오/오버레이/캡션을 전달하는지. 단일 파일 vs 모듈식 서브 컴포지션 호출에 대해서는 hyperframes-core/references/composition-patterns.md § 두 가지 아키텍처(경험 법칙: ≥3개의 하드 씬 컷, 또는 재사용된 씬 → 모듈화; 짧은 단일 씬 작품은 하나의 파일로 유지).
  3. 리듬 — 구현하기 전에 패턴 이름을 지정하세요(예: fast-fast-SLOW-SHADER-hold); 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 → “루트는 크기가 조정되어야 함” 참조). 이것을 건너뛰면 플렉스 컨테이너가 ~0으로 축소되고, 콘텐츠가 왼쪽 상단 모서리에 쌓이며, 첫 번째 문자가 x=0에서 잘립니다 — lint/inspect는 여전히 0개의 문제를 보고합니다. 그리고 항상 .scene-content에 padding(≥80px)을 유지하세요: 이것은 타이틀-안전 여백입니다. 절대 gap으로 대체하지 마세요.

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

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

빌드 — 도메인 스킬에 위임

이것은 스킬의 전체 표면(설명 참조)을 참조에 매핑합니다. 완전하지 않음; 의도가 나열되지 않은 경우 hyperframes-creative(외관/컨셉), hyperframes-animation(모션), hyperframes-core(계약), hyperframes-media(오디오/캡션)을 통해 경로를 찾으세요. 첫 번째 행은 추가적입니다 — 의도 행과 함께 읽고, 하나만 읽지 마세요.

구축…먼저 읽기 (순서대로)
항상 — 모든 사소하지 않은 작품, 아래 의도 행과 함께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
타이틀 카드 / 로우더-서드 / 오버레이 / 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 / 캡션hyperframes-media → 공유 오디오 엔진 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을 작성하고 hyperframes-media의 공유 엔진을 호출하세요. 하나의 스위치에서 자동으로 저하됩니다 — HeyGen 자격 증명 있음 → HeyGen TTS + 음악/SFX 검색; 없음 → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM 생성 및 번들 SFX 라이브러리. 전체 플래그 목록 + 요청/메타 스키마: hyperframes-media/scripts/audio.mjs의 헤더 주석.

// audio_request.json — 내레이션 세그먼트당 한 줄; `id`는 사용자 ID (audio_meta를 다시 연결)
{
  "lines": [
    { "id": "s1", "text": "당신의 오프닝 라인입니다.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "다음 비트입니다." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // "mode" 생략 → 자동 (HeyGen이면 검색, 아니면 생성); "none"으로 비활성화
}
# <MEDIA_DIR> = 설치된 hyperframes-media 스킬 디렉토리 (이 스킬의 형제)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

그런 다음 audio_meta.json을 읽으세요: 각 voices[].path를 (+ bgm.path, sfx[]) <audio> 트랙으로 마운트하고 voices[].words를 캡션에 사용하세요. 모두 hyperframes-core(오디오 트랙 + 캡션 작성)에 따릅니다. BGM이 생성 경로를 취한 경우(bgm_pending: true), 최종 렌더 전에 hyperframes-media/scripts/wait-bgm.mjs를 실행하세요.

출력 체크리스트 → hyperframes-cli

  • 작업이 자체 디렉토리를 생성하는지 확인하세요.
  • 오디오를 사용하는 경우 audio_meta.json이 존재하는지 확인하세요.
  • 구성이 hyperframes-core 계약을 따르는지 확인하세요.
  • lint 검사를 실행하세요.

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

관련 스킬