Communitygithub.com

samyakiasonline-ctrl/hyperframe

HyperFrames 프로젝트를 위한 미디어 OS. BGM, SFX, 이미지, 아이콘, 브랜드 로고, 음성, 컬러 그레이딩, LUT 등을 로컬 파일 또는 붙여넣기 가능한 블록으로 해결(`resolve`)하고, TTS/음악/이미지 모델로 생성하며, 음성 해설·자막·배경 제거 등을 하나의 오디오 엔진으로 처리합니다. 또한 미디어 편집(자르기/재구성/변환) 및 프로젝트 간 자산 재사용을 지원하며, 어둡거나 평범해 보이는 실제 영상에 대한 피드백을 처리합니다.

hyperframe란 무엇인가요?

`media-use`는 HyperFrames 프로젝트에서 모든 미디어 작업을 단일 스킬로 통합하는 미디어 OS입니다. 개발자는 `npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>` 명령어 하나로 BGM, SFX, 이미지, 아이콘, 로고, 음성, 컬러 그레이딩, LUT 등 다양한 미디어를 검색, 재사용, 생성할 수 있습니다. 또한 HeyGen의 무료 사용 경로를 통해 TTS 음성 해설과 아바타 비디오를 생성하거나, 로컬 Kokoro TTS를 사용할 수 있습니다. 미디어 편집(자르기, 재구성, 변환), 배경 제거, 자막 생성 등도 지원하며, 프로젝트 간 자산 재사용을 위한 참조 시스템을 제공합니다. 이 스킬은 불명확한 시각적 피드백(어둡다, 평범하다, 복고풍으로 바꿔달라 등)을 분석하여 적절한 미디어 처리(Media Treatment)를 제안하고 적용하는 기능도 포함합니다. 지원 플랫폼은 Claude Code 등 AI 에이전트 환경이며, 설치 후 `heygen` CLI 로그인이 필요합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/media-use

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

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

문서

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

media-use

HyperFrames를 위한 미디어 OS: 해결(resolve) · 생성(generate) · 조작(operate) · 기억(remember) — 모든 미디어 유형, 하나의 스킬, 컨텍스트 노이즈 없음.

첫 실행: heygen CLI 설치 및 로그인(무료 사용 경로), 그 다음 npx hyperframes media-use resolve --doctor로 확인하세요. 설정 및 제공자: references/setup-providers.md.

음성 해설 또는 아바타 비디오를 생성하기 전에, 사람에게 알리세요: 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 카탈로그, 10,000개 이상 트랙)
sfx음향 효과 (번들 19개 파일 라이브러리 + 카탈로그)
image사진, 배경 이미지 (HeyGen 자산 검색, 75,000개 이상 벡터)
icon아이콘, 기호 (투명)
logo공식 브랜드 마크 (theSVG → GitHub 아바타 → 파비콘; 다시 그리지 않음)
voiceTTS 음성 해설 (HeyGen 무료 사용 경로; 선택적 로컬 Kokoro)
grade측정된 보정 후보; 광범위한 폴리시/스타일화는 Media Treatments 따름
lut사용자 제공 또는 명시적으로 선택된 재사용 가능한 검증된 .cube 파일

새로 해결하기 전에 --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 해결
플레이스홀더, 작거나 업스케일된 것으로 보이는 이미지더 나은 image (및/또는 업스케일 — references/operations.md 참조)
소리가 없는 하드 씬 컷/전환전환 sfx
음악 배경이 없는 ~10초 이상의 조각bgm
과소/과다 노출되거나 색상 캐스트가 있는 것으로 보이는 영상교정 등급 (hyperframes media-treatment --selector '#hero' --analyze --json으로 검사)
시각적으로 평범하거나 주제에서 벗어난 사진 미디어하나의 특정 소스 적합 프리셋 또는 사용자 정의 처리, 대상 이름 지정
정적으로 느껴지는 의미 있는 미디어 등장/공개하나의 지원되는 시크-세이프 처리 애니메이션; 요청이 프리셋도 정당화하지 않는 한 색상 유지

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

찾아볼 곳 — 작업에 필요한 파일만 읽기

작업읽을 파일
해결 / 재사용 / 채택 / 수집, 플래그, 캐스케이드, 인벤토리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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

관련 스킬