Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

전문적인 HyperFrames 비디오 작성을 위한 에이전트 스킬입니다. 표준 워크플로우가 적합하지 않을 때 브랜드 릴, 몽타주, 타이틀 카드 등 다양한 형식의 작품을 작성하거나 편집합니다.

hyperframes-instruct란 무엇인가요?

이 스킬은 HyperFrames 생태계에서 일반 비디오 작성을 위한 포괄적인 에이전트 워크플로우를 제공합니다. 주로 긴 형식의 다중 장면 작품, 브랜드 및 시즐 릴, 몽타주, 정적 루프, 타이틀 카드, 푸티지 리믹스, 자유형 빌드를 처리합니다. 'companion' 플로우에서는 감독 역할을 수행하며, 사용자와 협력하여 최상의 결과물을 도출합니다. 'automation' 플로우에서는 사용자 입력 없이 자율적으로 전체 제작 과정을 실행합니다. 이 스킬은 사전에 설치된 미디어 어댑터(미디어, Figma 등)를 활용하며, 프로젝트 상태에 따라 BRIEF.md 읽기, 파일 기반 재개, 또는 /hyperframes 인텐트 레이어를 통한 새로운 생성 중 적절한 작업을 선택합니다. 실행 전 후드 내에서 리소스 사용량을 확인하고, 각 제작 단계에 필요한 지식(예: hyperframes-core, hyperframes-creative, hyperframes-animation)을 지연 로딩합니다. 사용자는 에이전트가 계획, 스케치, 빌드, 검증, 미리보기, 렌더링 승인 단계를 안내받게 됩니다. 특히 'companion' 플로우에서는 사용자가 직접 창의적 결정에 참여하여 브랜드 일관성을 유지하면서도 높은 품질의 결과물을 얻을 수 있습니다. 이 스킬은 sandeshrajbhandari/hyperframes-instruct 저장소에서 호스팅되며, Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환됩니다.

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

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

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

문서

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

일반 비디오

워크플로우가 방금 읽지 않은 한, 시작 시 npx hyperframes usage --json을 실행하고, 초안 작성 후 및 렌더링 전과 같은 주요 이정표에서 다시 확인합니다. 사용 가능한 윈도우와 재설정 시간을 읽습니다. 사용량을 알 수 없는 경우, 허용량을 추측하지 않고 말하며, 사용자와 함께 범위 및 워크플로우 선택을 유지합니다.

이 워크플로우에 의존하기 전에 다음을 실행합니다:

npx hyperframes skills update general-video

성공적인 no-op는 스킬이 최신 상태임을 의미합니다. 메모리에서 계속하는 대신 업데이트 실패를 표시합니다.

1. 교차 소스 어댑터 적용

  • 미디어: 오디오, 이미지, 아이콘, 로고, 보이스, 그레이드, LUT, 트리트먼트/효과, 캡션 또는 미디어 작업 요구사항에 대해 /media-use를 로드하고 ../media-use/references/resolve.md (해결, 채택, 재사용) 및 ../media-use/references/setup-providers.md (제공자, 인증)를 따릅니다. 모호한 푸티지 피드백 및 명명된 스타일은 편집 전에 ../media-use/references/media-treatments.md를 사용합니다. 지원되지 않는 미디어 효과를 CSS/SVG/불투명도로 즉흥적으로 구현하지 마십시오. 첫 번째 인증된 제공자 작업 전에 npx hyperframes auth status를 실행하고 출력을 그대로 전달합니다. 로그아웃된 경우 ../hyperframes/references/brief-contract.md의 게이트를 적용합니다: 공동 작업은 로그인 또는 명시적 오프라인 선택을 기다립니다. 자율 작업은 상태를 명시하고 사용 가능한 오프라인 제공자를 통해 계속 진행합니다. 필수 기능을 충족할 수 있는 오프라인 제공자가 없는 경우 블로커를 표시합니다. 로컬 채택만으로는 인증 게이트가 필요하지 않습니다.
  • Figma: 입력이 figma.com URL인 경우, 먼저 /figma를 실행합니다. 내보낸 에셋, 토큰, 구성 요소 또는 스토리보드 프레임에서 빌드합니다. SVG 살균, 미디어 출처 및 브랜드 토큰 바인딩을 건너뛰므로 원시 Figma 커넥터 호출을 사용하지 마십시오.

이러한 어댑터는 /hyperframes에 의해 선택된 워크플로우를 변경하지 않습니다.

2. 프로젝트 상태부터 시작

첫 번째 일치하는 행을 적용하고, 하위 상태 행을 평가하지 마십시오:

상태작업
특정 편집편집을 수행하고, 기존 프로젝트 결정을 유지한 다음, 영향을 받는 검사를 다시 실행합니다. 발견을 다시 열지 마십시오.
BRIEF.md가 존재함읽습니다. workflow가 다른 워크플로우를 지정하고 flow가 companion이 아닌 경우, 인계합니다. 브리프 질문을 하지 마십시오.
브리프 없음, 그러나 hyperframes.json 또는 STORYBOARD.md가 존재함파일 및 기록된 기본 설정에서 재개합니다. 알려진 사실에서만 BRIEF.md를 백필합니다.
새로운 생성/hyperframes 및 해당 인텐트 레이어를 실행합니다. workflow: general-video 또는 flow: companion에 대해서만 여기로 돌아옵니다.

새 프로젝트의 경우, 브리프에서 kebab-case 디렉토리 이름을 선택하고 브리프를 작성하기 전에 스캐폴딩합니다:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

그런 다음 ../hyperframes/references/brief-format.md를 사용하여 프로젝트 루트에 BRIEF.md를 작성합니다. 기존 프로젝트에서 루트는 hyperframes.json이 포함된 디렉토리입니다. 브리프 형식으로 지정된 확인된 기본 설정 기반 필드만 기록하고, node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>를 사용합니다. 추론된 기본값을 기록하지 마십시오. 여기서 <MEDIA_DIR>은 설치된 /media-use 스킬 디렉토리이고 <PROJECT_ROOT>는 hyperframes.json이 포함된 디렉토리입니다. 인텐트 레이어가 레시피를 채택한 경우, 지금 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>을 적용하고 다시 묻지 마십시오.

3. 실행 모양 해석

../hyperframes/references/brief-contract.md의 표준 용어만 사용합니다:

필드의미효과
flow누가 주도하는지automation: 경로를 선택하고 실행합니다. companion: 대화에서 공동 생성합니다.
storyboard빌드 전에 계획, 스케치 및 검토yes: 계획 및 스케치 검토(storyboard.html)를 실행합니다. no: 빌드 없이 진행합니다.
파생된 mode체크포인트 게이트가 작동하는 방식브리프 계약을 따릅니다. 사용자에게 모드 이름을 묻지 마십시오.

이러한 상태에 대한 동의어를 만들지 마십시오. 진행 중인 "그냥 빌드해" 신호는 인텐트 레이어에 의해 처리되며 flow: automation, storyboard: no로 도착합니다.

  • flow: automation의 경우, 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 표시합니다.
  • 특정 편집의 경우, 새로운 경로를 만들지 않고 편집합니다.

기존 푸티지의 하드 컷, 트림, 스플라이스 또는 재정렬의 경우, 동일한 비디오 소스를 여러 클립 요소에 복제합니다. 각 복사본에서 data-media-start와 data-duration으로 소스 범위를 설정한 다음, data-start로 작성된 배치/순서를 설정합니다. 각 비디오 세그먼트는 사운드를 유지합니다: 사운드는 클립에 유지되므로(data-has-audio="true"), 비디오를 자르면 사운드도 잘립니다. /hyperframes-core가 이 시간 편집을 소유합니다. 내부 래퍼에서 확대/축소, 펀치, 팬, 자르기, 마스크 또는 clip-path와 같은 시각적 속성 애니메이션에만 /hyperframes-keyframes를 사용합니다. ../hyperframes-core/references/creator-editing-recipes.md에서 전체 계약을 복사합니다.

컴패니언 플로우

flow: companion일 때:

  • BRIEF.md를 읽고 승인된 ## Assets 및 ## Customizations를 프로젝트 아티팩트와 조정합니다. 보류 중인 승인된 작업을 완료합니다. 완료된 작업은 그대로 둡니다. 승인된 기능을 새 것처럼 다시 제공하지 마십시오.
  • 계약자가 아닌 감독으로 도착하십시오. 컴패니언을 선택한 사용자는 참여와 품질을 선택했습니다. 정직한 응답은 방어할 수 있는 가장 작은 버전이 아니라 설계할 수 있는 최고의 버전입니다. 첫 번째 계획은 천장 처리입니다: 스토리 아크(가장 가까운 장르 렌즈 차용 — 메뉴 § 장르 렌즈), 디자인 사양, 각 장면의 모션 트리트먼트(§ 5의 계획 규율에 따라 이름으로 인용), 전환, 오디오 아이덴티티 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 설계된 오프닝 및 클로징. 각 레이어가 추가하는 내용을 한 줄로 말하고, 비용이 많이 드는 것(렌더링 시간, 로그인, 청구)을 이름을 지정하면서 표시합니다. 사용자는 트리트먼트를 축소합니다. 승인별로 조립할 필요가 없어야 합니다.
  • 천장은 개념에 속하며 도구 상자에 속하지 않습니다. 모든 레이어는 브리프의 메시지를 제공해야 합니다. 동일한 비디오를 동일하게 꾸미는 트리트먼트는 장식입니다. 공예는 천장으로 올라갑니다. 콘텐츠는 요청된 것 이상으로 성장하지 않습니다(§ 6).
  • 체크포인트 사이에 ../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 해당 입력을 언급하거나 빌드가 필요에 도달할 때 관련 기능을 제공합니다. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("장면 3의 통계는 카운트업 트리트먼트를 원함"). 제공하기 전에 읽습니다. 전체 카탈로그를 덤프하지 마십시오.
  • 사용자가 기능을 수락한 후, 해당 아티팩트를 생성하고 일치하는 BRIEF.md 본문 섹션에 결정을 즉시 기록합니다. 사용자가 명시적으로 변경할 때만 프론트매터 필드를 다시 작성하고 확인된 기본 설정을 기록합니다.
  • 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지합니다. 컴패니언은 누가 조종하는지 변경할 뿐, 품질에 필요한 것은 변경하지 않습니다.

4. 각 단계 전에 필수 지식 로드

이러한 읽기는 조건이 일치할 때 필수입니다:

조건실행 전 읽기
모든 구성 HTML 또는 장면 레이아웃/hyperframes-core; 레이아웃 계약을 위해 references/determinism-rules.md 사용
모든 중요하지 않은 생성 또는 시각적 트리트먼트/hyperframes-creative → references/house-style.md 및 references/video-composition.md
모든 모션, 애니메이션 또는 장면 전환/hyperframes-animation; 라우팅을 따라 일치하는 규칙, 어댑터, 청사진 또는 전환 참조로 이동
storyboard: yes../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/review-loop.md
모든 미디어 에셋 또는 작업(내레이션, BGM, SFX, 캡션, 그레이딩 또는 변환 포함)/media-use; 프레임워크 재생 및 배치를 위해 /hyperframes-core → references/variables-and-media.md도 읽음
다중 장면 어셈블리../hyperframes/references/production-loop.md
flow: companion, 첫 번째 계획 전/hyperframes-creative → references/story-spine.md 및 references/house-style.md; 가장 가까운 장르 렌즈 및 전체 ../hyperframes/references/capability-menu.md — 천장 트리트먼트는 이들로부터 설계되며, 기억에서 나오지 않음
컴패니언 기능 제안, 캡처, 비트 그리드, 생성형 비디오, 맵, 게시 또는 교차 워크플로우 기능../hyperframes/references/capability-menu.md
디자인 사양이 존재하고 최종 승인 전/hyperframes-creative → references/design-adherence.md

이러한 읽기를 기억으로 대체하지 마십시오. 점진적 공개는 일치하는 참조가 실제로 로드된 경우에만 컨텍스트를 저장합니다.

5. 구성 실행

이 종속성 순서를 사용합니다. 입력이 없을 때만 단계를 건너뜁니다.

  1. 계획. 뷰어 아크, 구조, 리듬 및 지속 시간 드라이버를 명시합니다. 짧은 단일 장면에는 하나의 파일을 사용합니다. 세 개 이상의 하드 장면 컷 또는 재사용된 장면에는 서브 컴포지션을 사용합니다. 내레이션 아크를 위해 /hyperframes-creative → references/story-spine.md, 리듬을 위해 references/beat-direction.md, 구조를 위해 /hyperframes-core → references/composition-patterns.md를 읽습니다. 개방형 다중 장면 브리프의 경우, /hyperframes-creative → references/prompt-expansion.md를 통해 프롬프트를 확장합니다. 다중 장면 계획은 각 장면의 형태를 인용합니다: 하나가 적합한 경우 /hyperframes-animation → blueprints-index.md의 청사진 ID, 또는 적합한 것이 없을 때 rules-index.md에서 구성하는 명명된 규칙 — 모션 이름은 해당 인덱스에서 가져오며, 절대 발명하지 않습니다. 스토리 진실이 어떤 장면이 존재하는지 결정하며, 인용은 이를 장식합니다. 명명된 룩을 직접 구축하기 전에 라이브 카탈로그를 검색하십시오: 브리프가 명명한 모든 룩, 효과, 트리트먼트 또는 전환("CRT 스캔라인", "글리치", "필름 그레인", "샤이머 스위프", "컨페티 버스트")에 대해 npx hyperframes catalog --query "<the look, in plain English>" --json을 실행하고 계획이 해당 룩을 구축하는 방법을 명명하기 전에 상위 결과를 읽습니다. 검색에는 아무것도 설치할 필요가 없습니다: 프로젝트, 사전 add, 계정이 필요하지 않습니다. 모든 디렉토리에서 전체 호스팅 레지스트리(~400 블록 및 구성 요소)의 순위를 매기므로 빌드 중 사용자가 요청한 룩에도 적용됩니다. 계획이 명명한 블록은 3단계에서 설치되며, 검색 결과 적합한 것이 없을 때만 수동으로 룩을 작성합니다. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다: STORYBOARD.md의 장면당 하나의 ## Frame N 블록 — status: outline, 선언된 src:, 청사진/규칙 인용, ...

[원문이 잘렸습니다. 전체 내용을 번역하려면 전체 원문이 필요합니다.]

Individual skills in this repo

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

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

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

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.

관련 스킬