Communitygithub.com

laviedezidane/hyperframes-skill

하이퍼프레임 프로젝트를 위한 미디어 OS. BGM, SFX, 이미지, 아이콘, 브랜드 로고, 음성, 컬러 그레이드 또는 LUT를 로컬 파일 또는 붙여넣기 가능한 블록으로 해결하고, 카탈로그에 없을 경우 TTS/음악/이미지 모델을 통해 생성하며, 공유 오디오 엔진으로 음성 해설, 자막, 배경 제거 등을 처리합니다.

hyperframes-skill란 무엇인가요?

이 스킬은 HyperFrames 프로젝트를 위한 포괄적인 미디어 운영 체제 역할을 합니다. 단일 `resolve` 명령어를 통해 BGM, SFX, 이미지, 아이콘, 로고, 음성, 컬러 그레이드, LUT 등 모든 미디어 유형을 검색, 생성, 변환 및 기억합니다. 카탈로그에서 누락된 미디어는 TTS, 음악 생성, 이미지 생성 모델을 통해 자동 생성하며, 하나의 공유 오디오 엔진으로 음성 해설, 자막, 배경 제거 등을 처리합니다. 또한 미디어 자르기, 프레임 변경, 변환과 같은 작업과 프로젝트 간 자산 재사용을 지원합니다. 시각적 피드백(어둡다, 평평하다, 지루하다, 레트로/캠코더/프린트/ASCII 느림, 프라이버시 필요 등)을 미디어 의도로 변환하여 적절한 조치를 취하며, 호스트 앱이 자체 음악/SFX 도구를 제공할 경우 이를 우선 사용하고, `HEYGEN_API_BASE` 환경 변수가 설정된 경우 헤이젠 CLI 로그인 없이 호스트를 통해 모든 헤이젠 호출을 처리합니다. Claude Code, Cursor, Codex 등 모든 에이전트 플랫폼에서 사용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/media-use

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

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

문서

플러그인 설치: 설치 또는 업데이트 명령 전에 이 스킬이 HyperFrames 플러그인 내부에 있는 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.

media-use

HyperFrames를 위한 미디어 OS: resolve · generate · operate · remember — 모든 미디어 유형, 하나의 스킬, 컨텍스트 노이즈 제로

환경 변수에 HEYGEN_API_BASE가 설정된 경우(호스트 앱이 설정하고 자체 키로 HeyGen 비용을 지불하는 경우): HeyGen 미디어는 이미 유료입니다. 사용자에게 heygen CLI를 설치하거나 로그인하도록 요청하지 말고, OAuth 허용량을 제안하지 마세요. 카탈로그 검색, TTS 및 아바타 호출은 여기서 호스트를 통해 이루어집니다. 동일한 호스트가 자체 HeyGen 도구도 제공하는 경우, 해당 도구를 먼저 사용하세요. 호스트를 통한 호출이 거부되면 사용자에게 호스트의 메시지를 그대로 전달하고(수정 방법을 명시함, 예: 앱 설정에서 키 추가 또는 교체) 중단하세요. 사용자가 요청하지 않는 한 다른 제공자로 전환하지 마세요.

그 외의 첫 실행 시(HEYGEN_API_BASE 없음), HeyGen 미디어(카탈로그 검색, TTS, 아바타 비디오)를 사용하는 경우: heygen CLI를 설치하고 로그인한 다음(무료 사용 경로), npx hyperframes media-use resolve --doctor로 확인하세요. 설정 및 제공자: references/setup-providers.md.

호스트 앱 내부의 음악 및 음향 효과: 실행 중인 앱이 자체 음악 또는 음향 효과 도구를 제공하는 경우 해당 도구를 사용하세요. HEYGEN_API_BASE 없이 resolve --type bgm 및 --type sfx는 heygen CLI를 통해 HeyGen 카탈로그를 검색합니다. 없으면 실패하고 그렇게 알립니다(sfx는 번들 라이브러리에서 여전히 응답합니다).

HEYGEN_API_BASE 없이, 음성 해설 또는 아바타 비디오를 생성하기 전에 사용자에게 알리세요: OAuth로 heygen CLI에 로그인하면(heygen auth login --oauth) TTS 음성 해설 및 아바타 비디오에 대한 무료 허용량이 제공되며, API 키는 API 크레딧을 청구합니다.

Resolve — 하나의 동사

npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>

한 줄 반환: resolved <id> → <path> (<type>, <metadata>). 모든 검색 노이즈는 디스크에 남습니다.

유형한 줄 의도
bgm배경 음악 (heygen CLI를 통한 HeyGen 카탈로그, 10,000+ 트랙)
sfx음향 효과 (번들 19개 파일 라이브러리 + heygen CLI를 통한 카탈로그)
image사진, 배경 (HeyGen 자산 검색, 75,000+ 벡터)
icon아이콘, 기호 (투명)
logo공식 브랜드 마크 (theSVG → GitHub 아바타 → 파비콘; 절대 다시 그리지 않음)
voiceTTS 음성 해설 (HeyGen 무료 사용 경로; 선택적 로컬 Kokoro)
grade측정된 보정 후보; 광범위한 광택/스타일화는 Media Treatments 따름
lut사용자 제공 또는 명시적으로 선택된 재사용 가능한 검증된 .cube 파일

새로 resolve하기 전에 --candidates로 재사용 가능한 후보를 나열하고 직접 적합성을 판단하세요 — 재사용 규칙, 모든 플래그, 수집(--from), 및 채택은 references/resolve.md에 있습니다.

광범위한 시각적 피드백을 미디어 의도로 처리

사용자가 사진 미디어를 수정, 광택, 스타일화, 가리기, 강조 또는 공개하도록 명시적으로 요청하면, 컬러 그레이딩이나 효과를 언급하지 않더라도 references/media-treatments.md를 읽으세요. 실제 <img>/<video>를 검사하고, 하나의 기본 의도를 선택한 다음, 결정론적 지속성 및 검증을 사용하세요. 일치하는 레시피를 선택적 테스트 시드로 사용하거나 hyperframes media-treatment --capabilities --json을 검사한 후, 관련 패밀리/효과 하나를 --capability <id>로 요청하고 정식 컨트롤에서 사용자 정의 처리를 조립하세요. 일반 저작을 위해 --all을 로드하지 마세요. 처리는 보정, 프리셋, 마무리, 호환되는 셰이더 효과, 지원되는 키프레임 및 선택적 Registry 오버레이를 구성할 수 있습니다. 소스에서 정당화된 제한된 튜닝과 호환되는 부분만 추가하고, 결과를 더 정교하게 보이게 하기 위한 효과만 추가하지 마세요. 최종 결합된 페이로드를 hyperframes media-treatment로 지속하세요.

점진적으로 확대되는 하나의 워크플로우를 사용하세요. 비디오의 경우, 프레임을 개별적으로 읽기보다는 레이블이 지정된 초기/중간/후반 접촉 시트 하나를 검사하세요. 일반 보정 또는 광택을 위해 후보 하나를 적용하고 후속 시트를 검사하세요. 결과가 모호하거나, 시간적이거나, 스타일화되거나, LUT 기반이거나, HDR/LOG에 민감하거나, 개인 정보이거나, 브랜드에 중요한 경우에만 개별 프레임 또는 움직이는 드래프트 증거로 확대하세요.

일반 보정 또는 광택의 경우 최종 처리의 프리셋/조정 JSON을 지속하세요.

노출, 그림자, 대비 또는 따뜻함만 인코딩하기 위해 .cube LUT를 생성하지 마세요. 사용자가 LUT를 제공하거나 선택한 처리가 명시적으로 LUT를 소유하는 경우에만 LUT를 사용하세요. resolve --type grade --for ... --analyze는 측정 증거이며, 선택한 처리를 생성된 LUT로 대체할 수 있는 권한이 아닙니다. 지원되는 비네트, 그레인, 블러, 픽셀화, 색상 또는 처리 효과를 CSS/SVG 오버레이로 재생성하지 마세요. 이는 Studio 컨트롤과 정식 미리보기/렌더링 셰이더 경로를 우회합니다.

능동적으로 행동하세요 — 미디어 기회 검사를 실행하세요

사용자는 일반적으로 어떤 미디어가 작품을 향상시킬지 알 수 없습니다. 당신은 알 수 있습니다. 구성을 빌드하거나 검토할 때 하나의 근거 있는 검사를 수행한 다음 한 번만 물어보세요 — 조용히 추가하지 말고, 자산당 귀찮게 하지 마세요.

구체적인 신호가 있을 때만 기회를 표면화하세요:

감지된 신호제안
화면상의 텍스트 / 음성 해설 없는 스크립트TTS 음성 해설 (오디오 엔진)
이모지 또는 아이콘으로 스타일링된 <div>실제 icon resolve
플레이스홀더, 작거나 업스케일된 이미지더 나은 image (및/또는 업스케일 — references/operations.md 참조)
소리 없는 하드 장면 컷 / 전환전환 sfx
음악 없이 ~10초 이상의 조각bgm
노출 부족/과다 또는 색조가 있는 영상교정 그레이드 (hyperframes media-treatment --selector '#hero' --analyze --json으로 검사)
시각적으로 평평하거나 주제와 맞지 않는 사진 미디어적절한 소스의 특정 프리셋 또는 사용자 정의 처리, 의도된 대상 명시
정적으로 느껴지는 의미 있는 미디어 등장/공개하나의 지원되는 시크-세이프 처리 애니메이션; 요청이 프리셋도 정당화하지 않는 한 색상 유지

이것을 도움으로 유지하고 성가심으로 만들지 않는 규칙: 근거 있음, 일반적이지 않음(신호 없음 → 제안 없음); 의견이 명확하고 구체적임(기본값으로 특정 수정 제안 — 사용자가 전부 / 일부 / 없음 승인); 프로젝트당 한 번(하나의 통합된 요청; "그대로 둬" 존중); 표면화, 절대 조용히 변이하지 않음(특히 컬러 그레이드: 제안하고 미리보기 — 그레이월드 "보정"은 의도적인 일몰 또는 네온 모양을 망칩니다).

어디를 볼까 — 작업에 필요한 파일만 읽으세요

작업읽을 파일
resolve / reuse / adopt / ingest, 플래그, 계단식, 인벤토리references/resolve.md
컬러 그레이딩, LUT, 스마트 그레이드 (--for), 그레이드 비교references/grading.md
음성 해설 / TTS, 음악, SFX, 자막, 트랜스크립션 (오디오 엔진)references/audio.md
기존 미디어 자르기 / 프레임 변경 / 변환, 정확한 오류 확산, HEVCreferences/operations.md
소스 인지형 창의적 처리, 실시간 효과, 오버레이, 공개references/media-treatments.md
설치 + 인증, 제공자 테이블, RAM 사다리, --local-only, --providerreferences/setup-providers.md
기억된 환경 설정 + 고정 레시피 (사용자 메모리)references/memory.md
소유권 매트릭스, 사용 통계, 텔레메트리, 프라이버시 (유지 관리자용)references/meta.md

Individual skills in this repo

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

laviedezidane/hyperframes-skill

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

관련 스킬