Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames 프로젝트를 위한 모든 미디어 요구를 단 하나의 스킬로 처리합니다. 배경음악, 효과음, 이미지, 아이콘, 브랜드 로고, 음성, 컬러 그레이딩, LUT를 로컬 파일이나 붙여넣기 가능한 블록으로 해결하고, 누락된 경우 TTS/음악/이미지 모델로 생성하며, 공유 오디오 엔진을 통해 음성 해설, 자막, 배경 제거 등을 처리합니다.

hyperframes-instruct란 무엇인가요?

이 스킬은 HyperFrames 프로젝트를 위한 포괄적인 미디어 운영체제로, 미디어 검색(resolve), 생성(generate), 변환(operate), 그리고 추적(remember)의 네 가지 핵심 동작을 단일 인터페이스로 제공합니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용할 수 있으며, `npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>` 명령어 하나로 모든 미디어 타입(배경음악, 효과음, 이미지, 아이콘, 로고, 음성, 컬러 그레이딩, LUT)을 처리합니다. HeyGen CLI를 통해 무료 TTS 음성 해설 및 아바타 비디오를 지원하며, API 키를 사용하면 API 크레딧으로 청구됩니다. 또한 사용자가 사진/비디오의 색감, 스타일, 프라이버시 보호, 미디어 효과 등에 대한 모호한 피드백을 줄 때 자동으로 적절한 미디어 처리(컬러 그레이딩, 프리셋, 쉐이더 효과 등)를 제안하고 적용할 수 있습니다. 프로젝트 내에서 한 번 사용한 에셋은 자동으로 로컬에 저장되어 재사용되며, 메모리 기능을 통해 사용자 선호도를 기억합니다.

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

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

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

문서

플러그인 설치: 설정 또는 freshness 명령어를 실행하기 전에 이 스킬이 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 "<설명>" --project <dir>

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

유형한 줄 의도
bgm배경 음악 (HeyGen 카탈로그, 1만 개 이상 트랙)
sfx음향 효과 (번들 19개 파일 라이브러리 + 카탈로그)
image사진, 배경 이미지 (HeyGen 에셋 검색, 7만 5천 개 이상 벡터)
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 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

관련 스킬